SocialCrawl

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 Fieldsengagement_rate, language, content_category, and estimated_reach on every response with a field map
  • Simple Auth — One API key in the x-api-key header
  • Credit-Based Billing — Pay only for what you use. No time-based rate limits. Cache hits are free.
  • 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

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.

Platform Developer Resources