Social Fetch MCP Server

Scraper API for TikTok, Instagram, YouTube, X & more.

View on socialfetch.dev

Documentation

Documentation

Look up profiles, posts, and engagement metrics across every major social platform through one normalized REST API.

Use with AI

Social Fetch is a REST API for normalized social media data. Look up profiles, posts, and engagement metrics across Instagram, TikTok, X/Twitter, YouTube, and more — one consistent JSON shape, one API key, and no scraping infrastructure to maintain.

Start with your AI tool

Paste this prompt into Cursor, Claude Code, or any AI IDE. It will read the docs and integrate Social Fetch for you.

PreviewCopy prompt

The essentials

Base URL https://api.socialfetch.dev · authenticate with the x-api-key: sfk_... header · grab the spec from /openapi.json. New here? Start with the Quickstart.

Pick your path

Quickstart

Make your first authenticated request and learn the response envelope in a few minutes.

TypeScript SDK

Typed client methods and Result-based error handling instead of raw HTTP.

API reference

Every operation, with parameters, examples, and response schemas.

Credits & billing

Which routes cost credits, how to read creditsCharged, and what 402 means.

Not sure where to begin? Match your setup:

  • Calling the API directly — Quickstart → Errors → Credits → API reference.
  • Building in TypeScript — Quickstart → SDK guide.
  • Handing this to a coding agent — point it at /llms.txt, /llms.json, and /openapi.json, or copy the prompt above.

Platform coverage

Every platform returns the same { data, meta } envelope, so you can add or switch sources without rewriting your client.

  • Instagram — profiles, posts, reels, highlights, search
  • TikTok — profiles, videos, products, user search
  • X/Twitter — profiles, tweets, communities, search
  • YouTube — channels, videos, transcripts, playlists, search
  • Facebook, LinkedIn, Reddit, Threads, Telegram, Spotify — profiles, posts, and platform-specific lookups
  • Web — fetch any page as Markdown or HTML, or ask a question about it
  • Utilities — whoami, balance, and health

The API reference groups every documented operation and links straight to its generated schema page — the fastest way to see the full surface area.

Docs for machines

Building with a coding agent or generating client code? These endpoints are designed to be read by tools:

  • Append .mdx to any docs URL for the raw Markdown, e.g. /docs/quickstart.mdx.
  • /llms.txt — curated index of the most important pages.
  • /llms.json — structured route inventory with parameters, pagination, outcomes, credits, and SDK mappings.
  • /openapi.json — full schema for codegen, validation, and tooling.

Quickstart

Authenticate, verify your API key, make a real Social Fetch request in multiple languages, and understand what to inspect in the response