# 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 "https://www.socialcrawl.dev/v1/prism/comment-leads?query=standing%20desk%20setup" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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