# SocialCrawl API

> Unified social media data API. One API key, one response format, 69 platforms, 679 endpoints.

Last updated: 2026-11-01

## Base URL

https://www.socialcrawl.dev/v1

## Authentication

Pass your API key in the `x-api-key` header with every request, or as `Authorization: Bearer <key>` if your client prefers that.

## Instructions

- Authenticate every request with the `x-api-key` header, or send the same key as `Authorization: Bearer <key>`. Never put the key in the URL or query string.
- Never invent endpoint paths. Endpoints live at `/v1/{platform}/{resource}` and are `GET` unless marked otherwise (a small set of batch and web endpoints are `POST`/`PATCH`/`DELETE`); fetch `/llms-{platform}.txt` for one platform's exact resource list with methods, or `/llms-full.txt` for all of them.
- For cross-platform questions ("who is talking about X"): To search one platform, call that platform's own search. To search several platforms over a date window with every row judged and de-duplicated, call `/v1/prism/discover`. For a quick fused sweep at a flat 20 credits, call `/v1/search/everywhere`, which drops rows outside `from_date`, `to_date`, `since` or `until` but reads one page per source, so a past window can come back thin. One `GET /v1/search/everywhere` call searches up to 20 sources and fuses the results; `GET /v1/prism/discover` answers in the call or continues in the background as a run you follow with `data.next.status_url`.
- For creators or influencers ("find influencers in Chile"): To find creators or influencers (by topic, market, size, or a product to promote), lookalikes of creators, or to measure and rank a list of creators you already have, call `/v1/prism/creators`. For shops, businesses and sellers, call `/v1/prism/discover` with `view=accounts`.
- For alerts and recurring watches ("tell me when"): To be told when something new appears, match the ask to its job: for a recurring digest of what is new about a topic, keyword or brand, every 1h or slower, call `POST /v1/prism/discover` with `schedule` (every `1h` or slower, `dry_run` first), read through `GET /v1/events` or a webhook endpoint; for the new posts or comments of an account or post you already know, call `POST /v1/monitors` with `webhook_rows: "new"`; for a one-off check of what is new since your last check, on an endpoint that takes `since` or `since_id`, call the endpoint's own `since` or `since_id` (for example `GET /v1/twitter/tweet/replies` with `since_id`, which returns an empty list and costs nothing when nothing is new); for metric snapshots of accounts you name (followers, views, likes), taken on a schedule, call `POST /v1/monitors` with a `track` metric; for reading what your watches produced, from a feed you poll or an endpoint that receives a signed push, call `GET /v1/events` with a named `consumer` for reading, and `/v1/webhook-endpoints` for push; for what a keyword or boolean topic listener would cost each month and how it reads the rule, before it is created, call `POST /v1/listening/streams?dry_run=1` with the listener body, which costs 0 credits and creates nothing; for each new mention of keywords or a boolean topic delivered one by one, every 30 minutes or slower, with boolean groups, a monthly cap and usage per client, and with `comments: "new_posts"` the comments under the Reddit posts it keeps, call `POST /v1/listening/streams?dry_run=1` to price it, then `POST /v1/listening/streams` to create the listener; for the new posts of up to 1,000 named business, brand, creator or organisation accounts that match a topic, every 30 minutes or slower, call `POST /v1/listening/streams?dry_run=1` with `accounts` (each a `platform:handle` such as `reddit:nasa` or `youtube:@Google`, or a profile URL), `schedule.purpose` (`business`, `brand`, `creator` or `organisation`) and `keywords`, then `POST /v1/listening/streams` to create the listener; for what is new on your listeners since the last read, in a later session or on a schedule you run yourself, call `GET /v1/events` with a named `consumer` and `types=mention.*`, then acknowledge each page with its `pagination.next_cursor`. A watch checks on a schedule and reports what that check found. A discover schedule is the same POST with `"schedule": {"every": "1d", "max_credits_per_run": 50, "name": "Acme daily"}`, where `every` is one of `1h`, `6h`, `12h`, `1d`, `7d`, `30d` (a daily digest is `"1d"`; a word such as "daily" is refused). Price it first by sending the same POST with `"dry_run": true` in the body (or `dry_run=1` on the URL): it is free and creates nothing. A schedule writes `discover.new_rows`, `discover.new_accounts`, `discover.new_items`, `discover.run_skipped`, `discover.run_failed` to `GET /v1/events` (`new_rows` for the rows view, `new_accounts` for `view=accounts`, `new_items` for `view=items`; the two `run_` types say a slot did not run). To learn what needs your attention (a monitor whose webhook was paused, a failed Discover run, a call refused for credits), call `GET /v1/notifications?unread=true` once a minute or less: every item has a `title` and a `next_step`; then send the ids you handled to `POST /v1/notifications/read`. Both cost 0 credits.
- Paginate every list the same way: read `pagination.next_cursor` from the response, send it back verbatim as the `cursor` query parameter, and stop when `pagination.has_more` is `false`. Never build or decode a cursor yourself. Before you fetch the next page, read `pagination.next_page_credits` (what that page costs; `null` when there is none) and `pagination.typical_page_size` (rows a full page holds): a smaller page with `has_more: true` is a short page, not the end.
- Cached responses cost 0 credits (`cached: true`, `X-Cache: HIT`). Only send `Cache-Control: no-cache` when you truly need a live fetch; it is billed at the normal rate.
- Errors are machine-readable. On any `success: false`, branch on `error.type` and follow `error.doc_url` to the exact fix instead of guessing.
- On a `429` or `503`, honor the `Retry-After` response header: wait that many seconds, then retry the same request. Credits are refunded on `502`/`503`, so retrying is safe.
- If one platform keeps failing with `502`/`503`, call `GET /v1/status` before retrying again, or `GET /v1/status/{platform}` for that platform's endpoints and open incidents. Both are public (no API key) and cost 0 credits: a platform reported `degraded` or `down` will not recover by retrying sooner. To watch status from your own tooling, poll the Statuspage-compatible https://www.socialcrawl.dev/status/api/v2/summary.json or follow https://www.socialcrawl.dev/status/history.rss.
- Additive changes are never breaking: response fields are only ever added, never removed or renamed. Parse defensively and ignore unknown fields, and your integration keeps working across versions.
- Need the raw Markdown of any docs page for your context window? Append `.md` to the URL (e.g. `/docs/quickstart.md`, `/docs.md`, `/docs/api-reference.md`) instead of scraping the rendered HTML.

## Start here

- Several platforms, a date window, every row judged and de-duplicated: `GET https://www.socialcrawl.dev/v1/prism/discover?brands={brand}&period=last_month&max_credits=150` ([guide](https://www.socialcrawl.dev/docs/prism/discover), [agent tools](https://www.socialcrawl.dev/docs/prism/discover-agents), [OpenAPI](https://www.socialcrawl.dev/openapi/prism-discover.json))
- Creators or influencers by topic, market, size or a product to promote: `GET https://www.socialcrawl.dev/v1/prism/creators?keywords={topic}&country={country}&dry_run=true` ([guide](https://www.socialcrawl.dev/docs/prism/creators), [OpenAPI](https://www.socialcrawl.dev/openapi/prism-creators.json)); agent tools: `socialcrawl_find_creators` starts a creator search (dry run first), shows `data.request.compiled` and the estimate, and relays `next_step`; `socialcrawl_creators_run` reads and steers a run: `list`, `wait`, `results`, `changes`, `resume`, `cancel` and `more`; reading is free; `socialcrawl_creators_manage` saves a run's creators and follows their new posts, showing the follow's dry run first; its writes carry an `Idempotency-Key`
- One platform: that platform's own search, listed in its `llms-{platform}.txt` below.
- Listening: watch keywords or boolean topics on Reddit, YouTube, X, Naver, Google News, TikTok, Facebook, Threads and LinkedIn on a schedule you choose, and receive only new, relevant mentions through a cursor feed, a named consumer or a signed webhook. Start with `POST https://www.socialcrawl.dev/v1/listening/streams?dry_run=1` (0 credits, creates nothing); add `"comments": "new_posts"` to also read the comments under the Reddit posts it keeps; agents read [/docs/listening/agents](https://www.socialcrawl.dev/docs/listening/agents) first ([guide](https://www.socialcrawl.dev/docs/listening/quickstart), [OpenAPI](https://www.socialcrawl.dev/openapi/listening.json))

## Platforms

- [aliexpress](https://www.socialcrawl.dev/llms-aliexpress.txt): 9 endpoints
- [amazon](https://www.socialcrawl.dev/llms-amazon.txt): 8 endpoints
- [app_store](https://www.socialcrawl.dev/llms-app_store.txt): 9 endpoints
- [apple_music](https://www.socialcrawl.dev/llms-apple_music.txt): 5 endpoints
- [bluesky](https://www.socialcrawl.dev/llms-bluesky.txt): 4 endpoints
- [content_analysis](https://www.socialcrawl.dev/llms-content_analysis.txt): 10 endpoints
- [douyin](https://www.socialcrawl.dev/llms-douyin.txt): 8 endpoints
- [ebay](https://www.socialcrawl.dev/llms-ebay.txt): 2 endpoints
- [economy](https://www.socialcrawl.dev/llms-economy.txt): 5 endpoints
- [etsy](https://www.socialcrawl.dev/llms-etsy.txt): 4 endpoints
- [facebook](https://www.socialcrawl.dev/llms-facebook.txt): 31 endpoints
- [finance](https://www.socialcrawl.dev/llms-finance.txt): 8 endpoints
- [g2](https://www.socialcrawl.dev/llms-g2.txt): 7 endpoints
- [gab](https://www.socialcrawl.dev/llms-gab.txt): 5 endpoints
- [github](https://www.socialcrawl.dev/llms-github.txt): 12 endpoints
- [google](https://www.socialcrawl.dev/llms-google.txt): 12 endpoints
- [google_news](https://www.socialcrawl.dev/llms-google_news.txt): 1 endpoint
- [google_play](https://www.socialcrawl.dev/llms-google_play.txt): 9 endpoints
- [google_shopping](https://www.socialcrawl.dev/llms-google_shopping.txt): 5 endpoints
- [google_trends](https://www.socialcrawl.dev/llms-google_trends.txt): 3 endpoints
- [gumtree](https://www.socialcrawl.dev/llms-gumtree.txt): 11 endpoints
- [hackernews](https://www.socialcrawl.dev/llms-hackernews.txt): 4 endpoints
- [hm](https://www.socialcrawl.dev/llms-hm.txt): 6 endpoints
- [home_depot](https://www.socialcrawl.dev/llms-home_depot.txt): 4 endpoints
- [instagram](https://www.socialcrawl.dev/llms-instagram.txt): 43 endpoints
- [jobs](https://www.socialcrawl.dev/llms-jobs.txt): 11 endpoints
- [kick](https://www.socialcrawl.dev/llms-kick.txt): 1 endpoint
- [klarna](https://www.socialcrawl.dev/llms-klarna.txt): 18 endpoints
- [kohls](https://www.socialcrawl.dev/llms-kohls.txt): 5 endpoints
- [komi](https://www.socialcrawl.dev/llms-komi.txt): 1 endpoint
- [kwai](https://www.socialcrawl.dev/llms-kwai.txt): 3 endpoints
- [linkbio](https://www.socialcrawl.dev/llms-linkbio.txt): 1 endpoint
- [linkedin](https://www.socialcrawl.dev/llms-linkedin.txt): 68 endpoints
- [linkme](https://www.socialcrawl.dev/llms-linkme.txt): 1 endpoint
- [linktree](https://www.socialcrawl.dev/llms-linktree.txt): 1 endpoint
- [naver](https://www.socialcrawl.dev/llms-naver.txt): 20 endpoints
- [on_page](https://www.socialcrawl.dev/llms-on_page.txt): 1 endpoint
- [perplexity](https://www.socialcrawl.dev/llms-perplexity.txt): 1 endpoint
- [pillar](https://www.socialcrawl.dev/llms-pillar.txt): 1 endpoint
- [pinterest](https://www.socialcrawl.dev/llms-pinterest.txt): 6 endpoints
- [polymarket](https://www.socialcrawl.dev/llms-polymarket.txt): 2 endpoints
- [prism](https://www.socialcrawl.dev/llms-prism.txt): 53 endpoints
- [producthunt](https://www.socialcrawl.dev/llms-producthunt.txt): 1 endpoint
- [quora](https://www.socialcrawl.dev/llms-quora.txt): 7 endpoints
- [reddit](https://www.socialcrawl.dev/llms-reddit.txt): 14 endpoints
- [rumble](https://www.socialcrawl.dev/llms-rumble.txt): 5 endpoints
- [search](https://www.socialcrawl.dev/llms-search.txt): 5 endpoints
- [sephora](https://www.socialcrawl.dev/llms-sephora.txt): 11 endpoints
- [snapchat](https://www.socialcrawl.dev/llms-snapchat.txt): 2 endpoints
- [spotify](https://www.socialcrawl.dev/llms-spotify.txt): 6 endpoints
- [target](https://www.socialcrawl.dev/llms-target.txt): 5 endpoints
- [tavily](https://www.socialcrawl.dev/llms-tavily.txt): 4 endpoints
- [telegram](https://www.socialcrawl.dev/llms-telegram.txt): 4 endpoints
- [threads](https://www.socialcrawl.dev/llms-threads.txt): 6 endpoints
- [tiktok](https://www.socialcrawl.dev/llms-tiktok.txt): 38 endpoints
- [tiktokshop](https://www.socialcrawl.dev/llms-tiktokshop.txt): 6 endpoints
- [tripadvisor](https://www.socialcrawl.dev/llms-tripadvisor.txt): 16 endpoints
- [trustpilot](https://www.socialcrawl.dev/llms-trustpilot.txt): 3 endpoints
- [truthsocial](https://www.socialcrawl.dev/llms-truthsocial.txt): 3 endpoints
- [twitch](https://www.socialcrawl.dev/llms-twitch.txt): 4 endpoints
- [twitter](https://www.socialcrawl.dev/llms-twitter.txt): 17 endpoints
- [us_congress_trades](https://www.socialcrawl.dev/llms-us_congress_trades.txt): 19 endpoints
- [utility](https://www.socialcrawl.dev/llms-utility.txt): 13 endpoints
- [walmart](https://www.socialcrawl.dev/llms-walmart.txt): 5 endpoints
- [wayfair](https://www.socialcrawl.dev/llms-wayfair.txt): 3 endpoints
- [web](https://www.socialcrawl.dev/llms-web.txt): 22 endpoints
- [xiaohongshu](https://www.socialcrawl.dev/llms-xiaohongshu.txt): 6 endpoints
- [yelp](https://www.socialcrawl.dev/llms-yelp.txt): 5 endpoints
- [youtube](https://www.socialcrawl.dev/llms-youtube.txt): 30 endpoints

## Credits

- Standard: 1 credit per request (389 endpoints)
- Advanced: 5 credits per request (244 endpoints)
- Premium: 10 credits per request (46 endpoints)

## Caching

- Successful responses are cached and shared across your account; cache hits cost 0 credits (`cached: true`, `X-Cache: HIT`).
- Freshness windows by data type: profiles ~15m, posts ~10m, comments ~5m, search ~2m, analytics ~30m.
- Force a live fetch with the `Cache-Control: no-cache` request header (billed at the normal rate; writes the fresh result back for the next caller). `no-store` alone does not trigger it.

## Idempotency

- Send an `Idempotency-Key` (UUID) request header to make a call safely retriable. Keys are reserved atomically per account before billing. A concurrent retry receives `409 IDEMPOTENCY_IN_PROGRESS` with a `Retry-After` of 1 second while the original is young, growing to a quarter of the time it has been running (at most 30); a crashed reservation expires after 5 minutes. Completed outcomes expire after 24 hours. The claim store fails closed before billing. A replay keeps the cached payload immutable except for billing metadata: `credits_used` is 0 and `idempotent_replay` is true. A known current balance is refreshed in body `credits_remaining` and the `X-Credits-Remaining` header; no balance row resolves to 0. On a transient balance lookup failure, body `credits_remaining` is null and `X-Credits-Remaining` is omitted. If a completed body exceeded the 64 KB replay limit, the same key receives `409 IDEMPOTENCY_REPLAY_UNAVAILABLE`; use a new key only to make a new billable request. GET Server-Sent Event requests cannot be replayed: use `Accept: application/json` when sending an idempotency key. The unsupported key-plus-SSE combination returns an unbilled `400 INVALID_REQUEST`. POST batch SSE keeps its documented sync-equivalent replay behavior.

## Common Agent Tasks

### Jobs

Customers arrive with a job, not an endpoint name. Each job below is the call (or chain) that does it, the example to copy, and the price of one run in credits. For a job in your own words, GET /v1/utility/plan?query=<the job> returns the calls with your values filled in. The same jobs, with a cURL each: /docs/common-jobs.

- Watch a brand: GET /v1/prism/brand-mentions?keyword=socialcrawl&date_from={start_date}&include=digest (50 credits). Find recent mentions of a brand on news sites, blogs and forums across the web, with a summary of what they say.
- What people say under a post: GET /v1/tiktok/post/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566&label=question%2Ccomplaint%2Cpurchase_intent (1 credit). Read the comments on a post and see which are questions, complaints or buyers, without judging them yourself.
- Mine comments for buyers: GET /v1/prism/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566 (2 to 120 credits). Collect up to 1,000 comments on a post, with replies on the top 100, and keep the ones that show buying intent.
- Profile, posts and comments for one creator: GET /v1/tiktok/profile?handle=charlidamelio → GET /v1/tiktok/profile/videos?handle=charlidamelio → GET /v1/tiktok/post/comments?url={url} (3 credits). Get a creator's profile, their recent posts, and the comments on one of those posts.
- One creator on every platform: GET /v1/prism/creator-card?handle=mrbeast&platforms=tiktok%2Cinstagram%2Cyoutube%2Ctwitter (5 credits). See the same creator's profiles on TikTok, Instagram, YouTube and X in one call.
- Track a creator daily: GET /v1/instagram/profile/posts?handle=instagram&since={last_run_date} (1 credit). Poll a creator's new posts every day, stopping at the date of your last run so each poll pays only for the pages it reads.
- Find creators in a niche: GET /v1/prism/creators?keywords=skincare+routine&platforms=tiktok%2Cinstagram&min_followers=50000 (0 to 200 credits). Find creators or influencers who post about a topic, filtered by platform, market and size, each measured from its recent posts and ranked with its reasons.
- Vet a creator: GET /v1/prism/creator-vet?handle=mkbhd&platform=youtube (50 credits). Check a creator before a partnership: audience, engagement and brand-safety signals in one call.
- Search a topic on several platforms: GET /v1/search/multi?query=matcha+latte&platforms=tiktok%2Cinstagram%2Cyoutube&relevance=filter (0 to 3 credits). Run one search on TikTok, Instagram and YouTube at once and keep only the posts that are about it.
- Find posts from people ready to buy: GET /v1/reddit/search?query=best+crm+for+startups&label=intent&relevance=filter (1 credit). Search discussions for a product category and mark the posts where someone is looking to buy.
- Transcribe a video: GET /v1/youtube/video/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ (3 credits). Get the full transcript of a video to search, summarise or quote it.
- See a competitor's ads: GET /v1/facebook/adlibrary/search/ads?query=artificial+intelligence (5 credits). List the ads a company is running, from the public ad library.
- What buyers say about a product: GET /v1/amazon/reviews?asin=B0BTYCRJSS&country=US&label=issue (5 credits). Read a product's reviews with the issue each one raises and its sentiment already judged.
- Monthly brand reaction: GET /v1/prism/discover?brands=aruba%2Ccuracao%2Cbonaire&period=last_month&exclude_terms=networks&max_credits=150 (0 to 150 credits). See how people reacted to a brand and its competitors over last month, across the social platforms and the news, judged and de-duplicated in one run.
- Find the accounts behind a topic: GET /v1/prism/discover?keywords=replica+rolex+dubai%2Cfake+watches+uae&context=accounts+selling+counterfeit+luxury+watches+in+the+UAE&view=accounts&period=90d&max_credits=400 (0 to 400 credits). Find the public accounts (sellers, creators, pages and channels) whose posts match a topic, each with its profile and the posts that matched.

### One endpoint per platform

Map a user's natural-language request to the flagship endpoint per platform
(all GET, `x-api-key` header; every endpoint is in llms-full.txt):

- "Get an AliExpress product by id or URL" → GET /v1/aliexpress/product · search: GET /v1/aliexpress/search
- "Get Amazon shop page" → GET /v1/amazon/shop · search: GET /v1/amazon/product-search
- "Search Apple App Store apps by keyword" → GET /v1/app_store/app-search · search: GET /v1/app_store/search-suggestions
- "Search Apple Music" → GET /v1/apple_music/search
- "Get a Bluesky profile" → GET /v1/bluesky/profile · search: GET /v1/bluesky/search
- "Search web citations of a keyword with per-mention sentiment" → GET /v1/content_analysis/search
- "Search Douyin videos" → GET /v1/douyin/search · search: GET /v1/douyin/search/users
- "Search eBay listings" → GET /v1/ebay/search
- "Get household spending by country and category" → GET /v1/economy/consumer-spend
- "Get an Etsy listing by id or URL" → GET /v1/etsy/product · search: GET /v1/etsy/search/suggestions
- "Get Facebook page profile" → GET /v1/facebook/profile · search: GET /v1/facebook/adlibrary/search/ads
- "Get a financial instrument quote" → GET /v1/finance/quote · search: GET /v1/finance/ticker-search
- "Get a G2 product by slug or URL" → GET /v1/g2/product
- "Get a Gab profile" → GET /v1/gab/profile · search: GET /v1/gab/search/posts
- "Get a GitHub user profile" → GET /v1/github/profile · search: GET /v1/github/search
- "Google web search" → GET /v1/google/search · search: GET /v1/google/adlibrary/advertisers/search
- "Search Google News" → GET /v1/google_news/search
- "Search Google Play apps by keyword" → GET /v1/google_play/app-search · search: GET /v1/google_play/search-suggestions
- "Search Google Shopping products" → GET /v1/google_shopping/product-search
- "Get Google Trends interest over time" → GET /v1/google_trends/explore
- "Search Gumtree UK listings" → GET /v1/gumtree/search · search: GET /v1/gumtree/search/suggestions
- "Search Hacker News" → GET /v1/hackernews/search
- "Search H&M products by keyword" → GET /v1/hm/search · search: GET /v1/hm/search/suggestions
- "Get a Home Depot product by item id or URL" → GET /v1/home_depot/product · search: GET /v1/home_depot/search
- "Get Instagram user profile" → GET /v1/instagram/profile · search: GET /v1/instagram/search/reels
- "Search LinkedIn job listings" → GET /v1/jobs/linkedin/search · search: GET /v1/jobs/indeed/search
- "Get Kick clip details" → GET /v1/kick/clip
- "Get a Klarna product by id or URL" → GET /v1/klarna/product · search: GET /v1/klarna/search
- "Search Kohl's products by keyword" → GET /v1/kohls/search
- "Get Komi page" → GET /v1/komi/page
- "Get a Kwai user profile" → GET /v1/kwai/profile
- "Get Linkbio page" → GET /v1/linkbio/page
- "Get LinkedIn user profile" → GET /v1/linkedin/profile · search: GET /v1/linkedin/search/companies
- "Get Linkme profile" → GET /v1/linkme/page
- "Get Linktree page" → GET /v1/linktree/page
- "Search Naver Blog" → GET /v1/naver/blog/search · search: GET /v1/naver/news/search
- "Run an on-page SEO audit for one URL" → GET /v1/on_page/page
- "Web research via Perplexity Sonar" → GET /v1/perplexity/research
- "Get Pillar page" → GET /v1/pillar/page
- "Search Pinterest pins" → GET /v1/pinterest/search
- "Search Polymarket prediction markets" → GET /v1/polymarket/search · search: GET /v1/polymarket/research
- "Universal post/product URL dispatcher: any post, video, product or repo link → the right detail endpoint's unified response." → GET /v1/prism/lookup
- "List current Product Hunt launches" → GET /v1/producthunt/launches
- "Search Quora questions" → GET /v1/quora/search
- "List Reddit subreddit posts" → GET /v1/reddit/subreddit · search: GET /v1/reddit/search
- "Search Rumble videos" → GET /v1/rumble/search
- "Universal social search across 15 platforms" → GET /v1/search/everywhere
- "Get a Sephora product by id or URL" → GET /v1/sephora/product · search: GET /v1/sephora/search
- "Get Snapchat user profile" → GET /v1/snapchat/profile
- "Get a Spotify artist" → GET /v1/spotify/artist · search: GET /v1/spotify/search
- "Get a Target product by TCIN" → GET /v1/target/product
- "Tavily web search with optional LLM-generated answer" → GET /v1/tavily/search
- "Get Telegram channel profile" → GET /v1/telegram/profile · search: GET /v1/telegram/search
- "Get Threads user profile" → GET /v1/threads/profile · search: GET /v1/threads/search
- "Get TikTok user profile" → GET /v1/tiktok/profile · search: GET /v1/tiktok/search
- "Get TikTok Shop product details" → GET /v1/tiktokshop/product · search: GET /v1/tiktokshop/search
- "Search TripAdvisor businesses & places" → GET /v1/tripadvisor/search
- "Search Trustpilot businesses" → GET /v1/trustpilot/business-search
- "Get Truth Social user profile" → GET /v1/truthsocial/profile
- "Get Twitch streamer profile" → GET /v1/twitch/profile
- "Get Twitter user profile" → GET /v1/twitter/profile · search: GET /v1/twitter/ai-search
- "Search US Congress stock trades" → GET /v1/us_congress_trades/trades
- "List every available endpoint" → GET /v1/utility/endpoints · search: GET /v1/utility/docs-search
- "Get a Walmart product by id" → GET /v1/walmart/product · search: GET /v1/walmart/search
- "Search Wayfair products" → GET /v1/wayfair/search
- "Scrape a web page" → GET /v1/web/scrape · search: GET /v1/web/search
- "Search Xiaohongshu notes" → GET /v1/xiaohongshu/search
- "Get a Yelp business by encid" → GET /v1/yelp/business/info · search: GET /v1/yelp/search
- "Get YouTube channel info" → GET /v1/youtube/channel · search: GET /v1/youtube/search

A typical success response uses this JSON envelope: { success, platform, endpoint, data, credits_used, credits_remaining }.
On billed responses, `credits_remaining` and `X-Credits-Remaining` are authoritative. Free cache hits return `credits_remaining: null` and omit the header because they do not establish an authoritative post-request balance. Idempotent replays return the current balance when their lookup succeeds; otherwise they return `credits_remaining: null` and omit the header. Routes that explicitly model an unavailable balance, including endpoint-parameter validation and best-effort metadata, omit both fields when their balance read fails.

## Key Pages

- [Platform catalog](https://www.socialcrawl.dev/platforms): every supported platform with live endpoint counts
- [Pricing & free credits](https://www.socialcrawl.dev/pricing): plans, credit packs, free tier
- [Status page](https://www.socialcrawl.dev/status): live and 90-day status per platform and endpoint, with incidents; [summary.json](https://www.socialcrawl.dev/status/api/v2/summary.json) (Statuspage format) and [RSS](https://www.socialcrawl.dev/status/history.rss)

## Guides & Comparisons

- [Best social media scraping APIs, compared](https://www.socialcrawl.dev/blog/best-social-media-scraping-apis-2026)
- [What is a unified social media API](https://www.socialcrawl.dev/unified-social-media-api)
- [MCP server & AI agent integration](https://www.socialcrawl.dev/solutions/ai-agents)
- [Brand monitoring on social media and in AI answers](https://www.socialcrawl.dev/solutions/brand-monitoring-api): prism/ai-visibility (Perplexity and Grok), search/everywhere and a Discover brand report, each with a priced weekly or daily schedule request
- [SocialCrawl vs alternatives](https://www.socialcrawl.dev/vs): comparison hub

## Data & Statistics

Computed, dated social-media statistics. Citable numbers refreshed on a cadence:

- [What are the best hashtags for TikTok? Ranked live from the trending feed, with a date](https://www.socialcrawl.dev/data/best-hashtags-for-tiktok)
- [What are the best hashtags for Instagram? Ranked live from top Reels, with a date](https://www.socialcrawl.dev/data/best-hashtags-for-instagram)
- [What are the best hashtags for YouTube Shorts? Ranked live from the trending Shorts feed, with a date](https://www.socialcrawl.dev/data/best-hashtags-for-youtube-shorts)
- [What are the best hashtags for Instagram Reels? Ranked live from a real Reels sample, with a date](https://www.socialcrawl.dev/data/best-hashtags-for-instagram-reels)
- [What are the best hashtags for Instagram growth? Ranked live from growth-focused Reels, with a date](https://www.socialcrawl.dev/data/best-hashtags-for-instagram-growth)
- [Which TikTok hashtags drive the most views? Ranked live by average views per trending video, with a date](https://www.socialcrawl.dev/data/best-tiktok-hashtags-for-views)
- [What TikTok hashtags are trending this week? Ranked from videos posted in the last 7 days on the trending feed, with a date](https://www.socialcrawl.dev/data/trending-tiktok-hashtags-this-week)
- [What is the average TikTok engagement rate? Median (likes+comments+shares)/views across public videos, with a date](https://www.socialcrawl.dev/data/average-tiktok-engagement-rate)
- [What is the average Instagram engagement rate? Median interactions per view across public Reels, with a date](https://www.socialcrawl.dev/data/average-engagement-rate-instagram)
- [What is the average engagement rate on social media? Cross-platform median interactions per view across public TikTok + Instagram posts, with a date](https://www.socialcrawl.dev/data/average-engagement-rate)
- [Who is the most followed person on Instagram? Ranked live by follower count across the top public accounts, with a date](https://www.socialcrawl.dev/data/most-followed-person-on-instagram)
- [What is the most followed account on Instagram? Ranked live by follower count across the platform's largest public accounts INCLUDING brand, club and platform accounts, so Instagram's own @instagram account is counted rather than filtered out, which is why this answer differs from the most-followed PERSON page; the biggest account other than @instagram is reported separately, with a date](https://www.socialcrawl.dev/data/most-followed-on-instagram)
- [Who has the most followers on YouTube? Ranked live by subscriber count across the world's biggest channels, with a date](https://www.socialcrawl.dev/data/who-has-the-most-followers-on-youtube)
- [What is the most viewed video on YouTube? Ranked live by lifetime view count across the platform's most watched videos, with a date](https://www.socialcrawl.dev/data/most-viewed-youtube-video)
- [What is the most viewed TikTok? Ranked live by lifetime play count across videos from well-known creators, with a date](https://www.socialcrawl.dev/data/most-viewed-tiktok)
- [What is the most liked TikTok? Ranked live by lifetime like count across videos from well-known creators, with a date](https://www.socialcrawl.dev/data/most-liked-tiktok)
- [What is the most retweeted tweet? Ranked live by public retweet/repost count across historically most-retweeted posts, with a date](https://www.socialcrawl.dev/data/most-retweeted-tweet)
- [What is the most liked tweet? Ranked live by public like count across historically most-liked posts, with a date](https://www.socialcrawl.dev/data/most-liked-tweet)
- [What is the most streamed song on Spotify? Ranked live by playcount across a basket of the platform's most-streamed tracks, with a date](https://www.socialcrawl.dev/data/most-streamed-song-on-spotify)
- [Who is the most streamed artist on Spotify? Ranked live by MONTHLY LISTENERS (unique accounts that played the artist in the last 28 days) across a basket of the biggest global artists, because Spotify publishes no per-artist career stream total, with a date](https://www.socialcrawl.dev/data/most-streamed-artist-on-spotify)
- [What are the top podcasts on Spotify? Ranked live by HOW MANY LISTENERS RATED each show (with the 0-5 average alongside) across a basket of the biggest shows, because Spotify publishes no play, download, subscriber or follower count for a podcast, with a date](https://www.socialcrawl.dev/data/top-podcasts)
- [How much do YouTubers make? A net RPM band applied to the median views per video, computed live from real channel data, with a date](https://www.socialcrawl.dev/data/how-much-do-youtubers-make)
- [How much money do YouTubers make a month? Median views per video times real upload cadence times a cited net RPM band, computed live, with a date](https://www.socialcrawl.dev/data/how-much-money-do-youtubers-make)
- [How much do YouTubers make per view? The cited net RPM band expressed per view and per 1,000 views, anchored to the median views per video from real channel data, with a date](https://www.socialcrawl.dev/data/how-much-do-youtubers-make-per-view)
- [How many followers do you need to get paid on TikTok? TikTok's published Creator Rewards (10,000 followers + 100,000 views/30 days) and LIVE (1,000 followers) thresholds, plus the median follower count of real earning creators, dated](https://www.socialcrawl.dev/data/how-many-followers-on-tiktok-to-get-paid)
- [How many subscribers do you need to get paid on YouTube? YouTube's published Partner Program thresholds (1,000 subscribers + 4,000 watch hours in 12 months or 10,000,000 Shorts views in 90 days) and the expanded fan-funding tier (500 subscribers), plus the median subscriber count of real earning channels, dated](https://www.socialcrawl.dev/data/how-many-followers-on-youtube-to-get-paid)
- [How many followers do you need to get paid on Snapchat? Snapchat's published Monetization Program criteria (50,000 followers + 15,000 hours of view time in 28 days, of which 3,000 from Spotlight) which make a creator eligible for an INVITATION rather than paying automatically, plus the median follower count of real Snap Stars, dated](https://www.socialcrawl.dev/data/how-many-followers-on-snapchat-to-get-paid)
- [How many followers do you need to get paid on Twitch? Twitch's published Affiliate Path (25 followers + 4 stream hours + 4 unique days + 3 average concurrent viewers) which makes a streamer eligible for an INVITATION rather than paying automatically, plus the median follower count of real earning streamers, dated. Partner has no published follower floor.](https://www.socialcrawl.dev/data/how-many-followers-on-twitch-to-get-paid)
- [How many followers do you need to get paid on Instagram? Instagram's published Subscriptions (10,000 followers on a professional account) and Gifts on Reels (500 followers) thresholds, which are necessary but not automatic payment, plus the median follower count of real earning creators, dated. Live Badges have no published follower floor.](https://www.socialcrawl.dev/data/how-many-followers-on-instagram-to-get-paid)
- [How many followers do you need to get paid on Facebook? Facebook's published Subscriptions (10,000 followers or 250 return viewers) and Stars (500 followers for 30 consecutive days) thresholds, which are necessary but not automatic payment, plus the median follower count of real earning Pages, dated. Content Monetization is invite-only with no published follower floor; in-stream ads ended 31 August 2025.](https://www.socialcrawl.dev/data/how-many-followers-on-facebook-to-get-paid)
- [Which Naver blog keywords have the most posts? Korean lifestyle keywords ranked by the size of the published Naver blog corpus for each (content supply and ranking difficulty, not search volume), read live from Naver Search and dated](https://www.socialcrawl.dev/data/naver-blog-top-keywords)
- [Which Naver blog keywords are least competitive? Korean side hustle and personal finance keywords ranked by how many blog posts already compete for each, so the smallest corpus is the least crowded to enter (content supply, not search demand), read live from Naver Search and dated](https://www.socialcrawl.dev/data/naver-blog-keyword-competition)
- [Which topics are discussed most on Naver Cafe? Korean subjects ranked by how many articles members have written about each across Korea's largest community platform (cumulative discussion volume, not search volume and not a ranking of cafes), read live from Naver Search and dated](https://www.socialcrawl.dev/data/naver-cafe-most-discussed)

## MCP Server

Install the official MCP server for Claude Code, Cursor, and Windsurf:

```
npx -y socialcrawl-mcp
```

## Reference

- [Full reference](https://www.socialcrawl.dev/llms-full.txt): complete endpoint documentation with parameters, examples, and response schemas
- [OpenAPI spec](https://www.socialcrawl.dev/v1/openapi.json): machine-readable API specification for every endpoint; for one platform, read its own document instead (for example https://www.socialcrawl.dev/openapi/tiktok.json), all listed in [Per-platform OpenAPI](https://www.socialcrawl.dev/openapi/index.json)
- [Machine-readable catalog](https://www.socialcrawl.dev/llms.json): JSON endpoint catalog
- [AI agent access file](https://www.socialcrawl.dev/agents.txt): crawler and agent onboarding