# Prism Comment Leads API (https://www.socialcrawl.dev/platforms/prism/comment-leads)

> Searches TikTok for `query`, decides which posts are worth opening, fetches the comments of those posts only, and returns the commenters who want to buy what you sell. Every searched post that reports comments is judged for whether people who want `offer` would plausibly comment under it; posts judged clearly off-offer are skipped, and the busiest of the rest (by reported comment count) are opened, up to `open`. Each fetched comment is then labelled for purchase intent (says they bought or want to buy, or asks for a link, a price or where to get it), for being a real question, for spam, and for whether `offer` would help its author; a comment is a lead when purchase intent is at least 0.5, spam below 0.5 and offer fit at least 0.5. Each lead carries the comment id and text, the commenter's public username and display name as the platform shows them, the post it came from and every probability. `posts_opened` gives per-post stats, `skipped_posts` lists every post not opened with its reason (`no_comments`, `no_url`, `below_gate`, `over_open_limit`) and its judgment, and `economics` reports posts searched and opened, comments fetched and judged, credits by leg, the credits held and refunded, an estimate of what opening every post would have cost at the same prices, and credits per lead. Measured on 15 real searches (5 Korean): with the default `open=12` it found 88% of the leads that opening every post found, at 0.96 credits a lead against 1.39. Posts that report no comments are never opened. If the post judgment is unavailable the busiest posts are opened instead (`_warnings: ['post_gate_unavailable']`); a comment that could not be labelled is never a lead and is not billed. `include=askers` adds comments that ask a question the offer would answer, as `kind: 'asker'`. Leads are labels for your own review: nothing is contacted.

TL;DR: `GET /v1/prism/comment-leads` costs Pay for what is opened: 1 credit a search page, 1 credit a comment page fetched and 1 credit for every started 25 comments labelled. The default request holds 37 and refunds what did not run; judging which posts to open is free and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | The keyword search to run (max 100 chars). |
| `offer` | no | What you sell, in one or two plain sentences (max 300 chars). Used to judge which posts would draw your buyers and whether each commenter would be helped by it. Default: the `query` itself. |
| `platform` | no | Platform to search. `tiktok` (default and, for now, only). (tiktok) |
| `posts` | no | How many posts to search (1-90, default 30; 30 posts a search page). |
| `open` | no | The most posts whose comments are fetched (1-20, default 12). |
| `comments_per_post` | no | The most comments read from each opened post (1-200, default 50; 50 comments a page). |
| `include` | no | Set `askers` to also return comments that ask a question the offer would answer, marked `kind: 'asker'`. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/prism/comment-leads" \
  --data-urlencode "query=standing desk setup" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Prism Comment Leads API return?

Returns buyer leads found in the comments of TikTok posts that match your search and your offer, each citing its comment and post, plus the posts opened and skipped and the credits spent. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Prism Comment Leads endpoint?

Use it when your leads sit in the comments rather than the posts, so you pay for the comments of the posts likely to hold buyers instead of every post.

### How much does the Prism Comment Leads API cost?

The price depends on the request, from 0 to 243 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Prism Comment Leads API need?

The one required parameter is query (the keyword search to run). It also accepts 6 optional parameters, all listed on this page.

### How do I call the Prism Comment Leads API?

Send a GET request to https://www.socialcrawl.dev/v1/prism/comment-leads?query=standing%20desk%20setup with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Prism Comment Leads API return?
- How do I get Prism Comment Leads data with the SocialCrawl API?