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

> Runs three exact-intent phrases ('alternative to X', 'X vs', 'switching from X') through content_analysis search in parallel, plus a Reddit (sort=new) and a Hacker News leg, then dedupes them into one feed. Since methodology leads/2 the ranking is judged: an AI classifier reads each candidate and answers five narrow questions (what the author is doing, whether the row is about the competitor product rather than a namesake, whether the author is a vendor, whether your offer would help them, how urgent the need is), and code combines those answers with recency and engagement into lead_score = (0.35 x P(asking, comparing or switching) + 0.20 x P(fits offer) + 0.15 x urgency/3 + 0.15 x recency + 0.15 x engagement) x P(about) x (1 - P(vendor)). Each lead carries intent { label, probabilities, about, seller, fits_offer, urgency, confidence } and lead_score; the label reads 'uncertain' when the classifier has no clear winner. Rows with P(about) below 0.3 (the snowflake on a Christmas jumper) are removed and their URLs listed in dropped_ids. The keyword intent_score and phrase_matched from leads-v1 are still on every row, and if the classifier is unavailable the feed falls back to that keyword order with _warnings: ['intent_unavailable'], intent: null and lead_score: null ('intent_partial' when only some rows could be judged). Conversation-level intent only: page-level matching, no author PII harvesting (web leads carry no handle by design, and no handle is sent to the classifier). Coverage spine is the three CA legs and does not depend on the classifier: <0.5 succeed → 50% refund; all five legs fail → full refund. Registers cleanly for a recurring-lead-feed monitor.

TL;DR: `GET /v1/prism/leads` costs 50 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `competitor` | yes | The competitor/product to mine alternative-seeking conversations for (≤80 chars). |
| `product_category` | no | Optional disambiguator appended to the social queries to cut cross-domain noise (e.g. 'project management'). |
| `freshness` | no | Recency floor. Nd/Nw/Nm (e.g. 30d) or an ISO date. Default 30d. |
| `include` | no | Set `comments` to attach top-thread Reddit comments to the top leads. |
| `limit` | no | Max leads in the fused feed (1-100, default 50). |
| `offer` | no | What you sell, in one or two plain sentences (max 300 chars). Used to judge whether each author would plausibly be helped by it (intent.fits_offer). Default: 'alternatives to {competitor}'. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/prism/leads" \
  --data-urlencode "competitor=notion" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Lead Generation API (Prism Leads)?

GET /v1/prism/leads takes a competitor name and returns a ranked feed of public conversations where people ask for alternatives to it or say they are switching away. It fans out across social and web sources and folds the intent signals into one scored list, so you skip building the search-and-rank pipeline yourself.

### What input does the leads endpoint need?

competitor is the only required parameter. Optionally pass product_category to disambiguate the space, freshness to bias toward recent posts, limit to cap the feed size, and include to toggle which source legs run.

### How is the feed ranked?

Each conversation is scored on how clearly it signals switching or alternative-seeking intent, then ranked so the strongest leads sit at the top. The response carries the source link for every item, so your team can act on the original post.

### How much does a leads call cost?

Each call is a flat 50 credits covering every source leg and the ranking. New accounts get 100 free credits with no credit card. If a strict majority of the legs fail, part of the cost is refunded automatically, and if all legs fail the full 50 credits come back.

### Why use leads instead of running competitor searches myself?

One call replaces the multi-source search, dedupe, intent-scoring, and ranking you would otherwise wire together by hand. You point it at a competitor and get back people already signaling they want out, ranked by intent, rather than a raw keyword dump.

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:

- How do I find people looking to switch away from a competitor via API?
- What API surfaces public conversations where people ask for alternatives to a product?
- sales intelligence API for competitor switching intent