SocialCrawl API
SocialCrawl API — unified social media data for developers and AI agents
One API key, one consistent response format, 42 platforms, 264 endpoints.
SocialCrawl is a unified social media data API that normalises data from 42 platforms into a single, consistent schema. Write one integration, query every platform — with computed fields like engagement_rate and estimated_reach pre-calculated on every response.
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?
- Unified Schema — Every platform returns the same envelope, so you write one parser
- 264 Endpoints — Profiles, posts, comments, search, transcripts, ad libraries, and more
- Computed Fields —
engagement_rate,language,content_category, andestimated_reachon every response with a field map - Simple Auth — One API key in the
x-api-keyheader - Credit-Based Billing — Pay only for what you use. No time-based rate limits. Cache hits are free.
- Safe Retries — Send an
Idempotency-Keyheader 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
Explore all 264 endpoints with an interactive playground, code examples in 20+ languages, and response schemas in the 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.
Why use a unified API?
Instead of building and maintaining 35 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, errors carry a doc_url you can link users to, and computed fields arrive pre-calculated so your application logic stays simple.
Which platforms does SocialCrawl support?
Frequently asked questions
How do I authenticate with the SocialCrawl API?
Pass your API key in the x-api-key header on every request. Sign up at socialcrawl.dev, open Dashboard → API Keys, and create a key — there is no OAuth flow, token exchange, or session to manage.
Which platforms does the SocialCrawl API support?
SocialCrawl covers 42 platforms through 264 endpoints — including TikTok, Instagram, YouTube, Facebook, Twitter/X, LinkedIn, Reddit, Threads, Pinterest, and Twitch — plus research sources like GitHub, Hacker News, Tavily, and Perplexity.
What does the SocialCrawl response envelope look like?
Every response — success or error — uses the same JSON envelope: success, platform, endpoint, data, credits_used, credits_remaining, request_id, and cached. List responses return data as { items, next_cursor }, and computed fields like engagement_rate arrive pre-calculated on every author and post.
How do I use SocialCrawl with Claude, Cursor, or other MCP clients?
Install the MCP server with npx -y socialcrawl-mcp. In Claude Code, run: claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp. In Claude Desktop, Cursor, VS Code, or Windsurf, add socialcrawl-mcp to your mcpServers config with your SOCIALCRAWL_API_KEY.
How many free credits do I get when I sign up?
Every new account receives 100 welcome credits automatically on signup. Standard endpoints cost 1 credit per request, so that is up to 100 free requests to evaluate the API — and cache hits cost 0 credits.
