# SocialCrawl API (/docs)



One API key, one consistent response format, 49 platforms, 395 endpoints.

SocialCrawl is a unified social media data API that normalises data from 49 platforms into a single, consistent schema. Write one integration and query every platform. When an endpoint supports a computed field and the required source inputs are present, optional fields such as `engagement_rate` and `estimated_reach` arrive pre-calculated.

SocialCrawl covers platforms reaching over 10 billion combined monthly active users — including TikTok (1.5B+ MAU), Instagram (2B+ MAU), YouTube (2.7B+ MAU), and Facebook (3B+ MAU).

What can SocialCrawl do? [#what-can-socialcrawl-do]

* **Unified Schema** — Every platform returns the same envelope, so you write one parser
* **395 Endpoints** — Profiles, posts, comments, search, transcripts, ad libraries, and more
* **Computed Fields** — When the endpoint supports them and the required source inputs are present, optional fields can include `engagement_rate`, `language`, `content_category`, and `estimated_reach`
* **Simple Auth** — One API key in the `x-api-key` header
* **Credit-Based Billing** — Pay only for what you use. Cache hits are free. Generous per-key rate and concurrency limits (see [Rate Limits](/docs/rate-limits.md)).
* **Safe Retries** — Send an `Idempotency-Key` header and we guarantee a single charge per key for 24 hours
* **Account Metadata** — Check your balance programmatically via `GET /v1/credits/balance` (0 credits)

API Reference [#api-reference]

Explore all 395 endpoints with an interactive playground, code examples in 20+ languages, and response schemas in the [API Reference](/docs/api-reference.md).

For copy-paste TypeScript that solves real cross-platform tasks — brand mention monitoring, sentiment analysis, competitor tracking, TikTok analytics, multi-platform transcripts, ad-library aggregation — see the ten [Recipes](/docs/recipes.md).

Why use a unified API? [#why-use-a-unified-api]

Instead of building and maintaining 49 separate platform integrations — each with its own authentication, rate limits, response format, and error codes — SocialCrawl gives you one consistent interface. Every response follows the same envelope, and errors carry a `doc_url` you can link users to. When an endpoint supports a computed field and the required source inputs are present, that field arrives pre-calculated.

Which platforms does SocialCrawl support? [#which-platforms-does-socialcrawl-support]

<PlatformTable />

Frequently asked questions [#frequently-asked-questions]

<DocsFaq page="index" />

Platform Developer Resources [#platform-developer-resources]

* [TikTok for Developers](https://developers.tiktok.com/)
* [Instagram Graph API](https://developers.facebook.com/docs/instagram-api/)
* [YouTube Data API](https://developers.google.com/youtube/v3)
* [X/Twitter API](https://developer.x.com/)
* [LinkedIn API](https://learn.microsoft.com/en-us/linkedin/)
* [Reddit API](https://www.reddit.com/dev/api/)


## All documentation pages

Append `.md` to any `/docs/...` URL to read that page as Markdown.

- [AI Agent Integration](/docs/ai-agents.md)
- [Authentication](/docs/authentication.md)
- [Batch endpoints](/docs/batch.md)
- [Billing Webhooks](/docs/billing-webhooks.md)
- [Caching](/docs/caching.md)
- [Which Endpoint Should I Use?](/docs/choosing-endpoints.md)
- [Claude Code](/docs/claude-code.md)
- [Cohorts](/docs/cohorts.md)
- [Computed fields](/docs/computed-fields.md)
- [Credits](/docs/credits.md)
- [Endpoint pricing](/docs/endpoint-pricing.md)
- [Error Handling](/docs/errors.md)
- [SocialCrawl API](/docs.md)
- [LangChain](/docs/langchain.md)
- [Metric substitutions and structural nulls](/docs/metric-substitutions.md)
- [n8n](/docs/n8n.md)
- [Pagination](/docs/pagination.md)
- [Quickstart](/docs/quickstart.md)
- [Rate Limits](/docs/rate-limits.md)
- [Response Schema](/docs/response-schema.md)
- [Schema Compatibility Promise](/docs/schema-compatibility.md)
- [Skills & MCP Server](/docs/skills-and-mcp.md)
- [Streaming (SSE)](/docs/streaming.md)
- [Vercel AI SDK](/docs/vercel-ai-sdk.md)
- [Versioning & Deprecation](/docs/versioning.md)
- [Monitor Webhooks](/docs/webhooks.md)
- [Amazon](/docs/amazon.md)
- [Bluesky](/docs/bluesky.md)
- [Apple App Store](/docs/app_store.md)
- [Content Analysis](/docs/content_analysis.md)
- [eBay](/docs/ebay.md)
- [Facebook](/docs/facebook.md)
- [Google](/docs/google.md)
- [GitHub](/docs/github.md)
- [Google Finance](/docs/google_finance.md)
- [Google News](/docs/google_news.md)
- [Google Shopping](/docs/google_shopping.md)
- [Google Trends](/docs/google_trends.md)
- [Apple Music](/docs/apple_music.md)
- [Google Play](/docs/google_play.md)
- [Hacker News](/docs/hackernews.md)
- [Instagram](/docs/instagram.md)
- [Home Depot](/docs/home_depot.md)
- [Kick](/docs/kick.md)
- [Komi](/docs/komi.md)
- [Kwai](/docs/kwai.md)
- [LinkBio](/docs/linkbio.md)
- [LinkedIn](/docs/linkedin.md)
- [LinkMe](/docs/linkme.md)
- [Linktree](/docs/linktree.md)
- [Naver](/docs/naver.md)
- [Perplexity](/docs/perplexity.md)
- [Pillar](/docs/pillar.md)
- [Pinterest](/docs/pinterest.md)
- [Polymarket](/docs/polymarket.md)
- [Prism](/docs/prism.md)
- [Reddit](/docs/reddit.md)
- [Rumble](/docs/rumble.md)
- [Ad library aggregation](/docs/recipes/ads-library-aggregation.md)
- [Brand mention monitoring](/docs/recipes/brand-mention-monitoring.md)
- [Competitor tracking](/docs/recipes/competitor-tracking.md)
- [Creator engagement scoring](/docs/recipes/creator-engagement-scoring.md)
- [Recipes](/docs/recipes.md)
- [Music trend detection](/docs/recipes/music-trend-detection.md)
- [Hybrid search-then-enrich](/docs/recipes/search-then-enrich.md)
- [Sentiment analysis](/docs/recipes/sentiment-analysis.md)
- [Social listening pulse-check](/docs/recipes/social-listening-pulse-check.md)
- [TikTok analytics dashboard](/docs/recipes/tiktok-analytics-dashboard.md)
- [Video transcription](/docs/recipes/video-transcription-api.md)
- [Universal social search](/docs/search/everywhere.md)
- [Universal Search](/docs/search.md)
- [Universal news search](/docs/search/news.md)
- [Snapchat](/docs/snapchat.md)
- [Spotify](/docs/spotify.md)
- [Target](/docs/target.md)
- [Tavily](/docs/tavily.md)
- [Threads](/docs/threads.md)
- [TikTok](/docs/tiktok.md)
- [App schema](/docs/schema/app.md)
- [Author schema](/docs/schema/author.md)
- [Comment schema](/docs/schema/comment.md)
- [Cross-platform field equivalence](/docs/schema/field-equivalence.md)
- [Unified schema](/docs/schema.md)
- [Job schema](/docs/schema/job.md)
- [Media list schema](/docs/schema/media-list.md)
- [News article schema](/docs/schema/news-article.md)
- [Place schema](/docs/schema/place.md)
- [Post schema](/docs/schema/post.md)
- [Product schema](/docs/schema/product.md)
- [Quote schema](/docs/schema/quote.md)
- [Review schema](/docs/schema/review.md)
- [Seller schema](/docs/schema/seller.md)
- [Transcript schema](/docs/schema/transcript.md)
- [Web page schema](/docs/schema/web-page.md)
- [TikTok Shop](/docs/tiktokshop.md)
- [Tripadvisor](/docs/tripadvisor.md)
- [Trustpilot](/docs/trustpilot.md)
- [Truth Social](/docs/truthsocial.md)
- [Twitch](/docs/twitch.md)
- [Twitter/X](/docs/twitter.md)
- [Walmart](/docs/walmart.md)
- [Web Scraping](/docs/web.md)
- [YouTube](/docs/youtube.md)
- [Utility](/docs/utility.md)
- [API Reference](/docs/api-reference.md)