# Universal Search Everywhere API (https://www.socialcrawl.dev/platforms/search/everywhere)

> Fans out a single query across Reddit, X (ai-search), YouTube, TikTok, Instagram, Hacker News, Polymarket, GitHub, Threads, Pinterest, Perplexity, and Tavily in parallel. Returns ranked + clustered results, enriched with **real-people comments** from each post — Reddit upvoted comments, HackerNews thread replies, YouTube/TikTok/Instagram top-liked comments, GitHub issue discussion. The top comment per result lives at `data.items[i].source_items[0].metadata.top_comments[]` (sorted by score descending, capped at 5, max 300-char excerpts). Supports streaming via `Accept: text/event-stream` (emits `comments_enriched` chunks per candidate as enrichment lands, before the terminal `done`) and sync via `Accept: application/json`. Flat 20 credits per call regardless of enrichment.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search query (1–512 chars) |
| `lookback_days` | no | Days to look back (1–365+, default 30); mutually exclusive with from_date/to_date. |
| `from_date` | no | ISO YYYY-MM-DD lower bound; mutually exclusive with lookback_days. |
| `to_date` | no | ISO YYYY-MM-DD upper bound; defaults to today when from_date is set alone. |
| `sources` | no | Optional CSV allowlist of source names (mutually exclusive with exclude). |
| `exclude` | no | Optional CSV blocklist of source names (mutually exclusive with sources). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/search/everywhere?query=kanye%20west" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I use the social media search API?

Send GET /v1/search/everywhere?query=your+topic with your API key. SocialCrawl fans the query out across Reddit, X, YouTube, TikTok, Instagram, Hacker News, Polymarket, GitHub, Threads, Pinterest, Perplexity, and Tavily in parallel and returns one ranked, clustered JSON result set.

### What parameters does /v1/search/everywhere accept?

query is required (1–512 characters). Optional: lookback_days (default 30), from_date and to_date for an explicit ISO date range, sources for a CSV allowlist of platforms, and exclude for a CSV blocklist. lookback_days and the date range are mutually exclusive, as are sources and exclude.

### What does each search result include?

Each ranked item carries the post, its platform, engagement and freshness signals, and real top comments — up to 5 per result, sorted by score, with 300-character excerpts. Comments come from the platforms themselves: Reddit upvoted replies, YouTube and TikTok top-liked comments, GitHub issue discussion.

### Can I restrict the search to specific platforms?

Yes. Pass sources as a CSV allowlist (for example sources=reddit,youtube,github) to fan out only to those platforms, or exclude as a blocklist to skip platforms. The price stays a flat 20 credits either way.

### How much does one search everywhere call cost?

A flat 20 credits per call, regardless of how many sources fire or how much comment enrichment lands. If the pipeline produces zero ranked items, the credits refund automatically — sync and streaming both.

### Does the endpoint support streaming responses?

Yes. With Accept: text/event-stream you get typed SSE chunks, including comments_enriched chunks as each candidate's comments land, before the terminal done event. With Accept: application/json (the default) you get one synchronous envelope.

See the full Universal Search API: https://www.socialcrawl.dev/platforms/search

## 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 to use the SocialCrawl search everywhere endpoint
- What does GET /v1/search/everywhere return?