# 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 and intent-ranks them into one feed with a per-lead phrase_matched + intent_score and a counts_by_phrase breakdown. Conversation-level intent only — page-level matching, no author PII harvesting (web leads carry no handle by design). Coverage spine is the three CA legs: <0.5 succeed → 50% refund; all five legs fail → full refund. Deterministic (no LLM); 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). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/leads?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