# Prism Audience Questions API (https://www.socialcrawl.dev/platforms/prism/audience-questions)

> Searches Reddit and YouTube (and optionally the universal web search) for a topic, extracts question-shaped titles and comments, and LLM-clusters them into labeled intent groups with verbatim quotes and per-question source counts (the model only labels/groups — counts and quotes are recomputed in code). The clustering degrades to one ungrouped cluster on LLM failure (no refund). Coverage spine = the per-source search legs (<0.5 → 50% refund; all dead → full refund). Great for content/SEO briefs and FAQ generation.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `topic` | yes | The topic/keyword to mine audience questions for. |
| `platforms` | no | CSV subset of reddit,youtube,web (default reddit,youtube). |
| `max_questions` | no | Cap on questions returned. |
| `threads_per_source` | no | How many top threads to dig per source. |
| `timeframe` | no | Recency window. |
| `include` | no | Set `web` to add the universal-search leg. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/audience-questions?topic=kubernetes%20operators" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl audience questions API?

GET /v1/prism/audience-questions harvests the real questions an audience asks about a topic from Reddit and YouTube threads, then clusters them by intent into who, what, why, how, and vs buckets. One call replaces manually reading dozens of threads to find what people actually want answered.

### How do I use it for content research?

Pass topic and the composite pulls threads from Reddit and YouTube, extracts genuine questions, and returns them grouped by intent so you can turn them straight into an FAQ, a video outline, or a content brief. It surfaces the phrasing your audience uses, not keyword-tool guesses.

### Which parameters shape the harvest?

The platforms parameter chooses which sources to mine, max_questions caps how many questions come back, and threads_per_source controls how deep the crawl goes on each platform. Use timeframe to bound recency and include to pick which supporting sections are returned.

### How much does an audience-questions call cost?

Each call is a flat 30 credits and returns one synchronous JSON response. If a strict majority of the source legs fail the call is partial-refunded, and if every leg fails the full 30 credits are refunded automatically. New accounts get 100 free credits with no card required.

### How are questions clustered by intent?

Extracted questions are grouped into who, what, why, how, and vs clusters so comparison and how-to demand are separated from definitional queries. Counts per cluster are recomputed in code from the assigned questions, and each question keeps a link back to the thread it came from.

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 the real questions my audience asks about a topic via API?
- Which API pulls questions from Reddit and YouTube and clusters them by intent?
- Is there a content research API that returns people-also-ask style questions from social threads?