# SocialCrawl API (/docs)



One API key, one consistent response format, 48 platforms, 381 endpoints.

SocialCrawl is a unified social media data API that normalises data from 48 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
* **381 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)).
* **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 381 endpoints with an interactive playground, code examples in 20+ languages, and response schemas in the [API Reference](/docs/api-reference).

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).

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

Instead of building and maintaining 48 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/)