scrapecreators-api

ScrapeCreators API

Scrape and extract public data from 27+ social media platforms. 110 endpoints available.

Base URL: https://api.scrapecreators.com

Get your API key at https://scrapecreators.com

How to Call

All endpoints use GET requests. Pass query params in the URL and authenticate with the x-api-key header. Responses are JSON.

curl -s "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio" \
  -H "x-api-key: $SCRAPECREATORS_API_KEY"

Or with fetch:

const res = await fetch(
  "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio",
  { headers: { "x-api-key": process.env.SCRAPECREATORS_API_KEY } }
);
const data = await res.json();

Endpoint paths use the pattern /v1/platform/action. The tables below list each endpoint path and its required params.

API Spec

Each endpoint has its own OpenAPI spec at https://docs.scrapecreators.com/{path}/openapi.json.

For example: https://docs.scrapecreators.com/v1/tiktok/profile/openapi.json

Important: Once you've determined which endpoint(s) to call from the routing tables below, fetch the single-endpoint OpenAPI spec first to get the full parameter details, types, and example response before making the actual API call.

The full spec covering all endpoints is at https://docs.scrapecreators.com/openapi.json (large file — prefer the per-endpoint specs above).

Intent Routing

Map user intent to the right endpoint. After selecting an endpoint, fetch its OpenAPI spec at https://docs.scrapecreators.com/{path}/openapi.json for full param details before calling.

Profiles / User Info

Posts / Content Feeds

Single Post / Video Details

Comments

Transcripts

Search

Ad Libraries

Trending / Popular

Followers / Following / Live (TikTok only)

TikTok Shop

Link-in-Bio / Other

Credit Costs

Most endpoints cost 1 credit per request. Exceptions:

Check balance with /v1/credit/balance. Warn users before calling expensive endpoints.

Pagination

Paginated endpoints return a cursor/token in the response. Pass it back as a query param to get the next page.

Common Optional Params

• trim (boolean): reduces response payload size. Use when you only need key metrics.
• region (string): 2-letter country code for proxy location. Does NOT filter by region -- just routes the request through that country's proxy.

Known Limitations

• Handles: pass without the @ symbol. Use charlidamelio not @charlidamelio. Applies to TikTok, Instagram, Twitter, Threads, Bluesky, Snapchat, Twitch, Pinterest, Truth Social
• YouTube handles: pass without the @ symbol. Use ThePatMcAfeeShow not @ThePatMcAfeeShow. You can also pass a channelId (e.g. UC-9-kyTW8ZkZNDHQJ6FgpwQ) or full URL instead
• Hashtags: pass without the # symbol. Use fyp not #fyp. Applies to TikTok and YouTube hashtag search endpoints
• Twitter: returns ~100 most popular tweets, not chronological/latest
• Threads: only last 20-30 posts visible publicly
• Facebook posts: only 3 posts per page (API limitation)
• Facebook group posts: only 3 posts per page (same API limitation)
• LinkedIn company posts: max 7 pages
• Instagram play counts: IG-only views (excludes cross-posted FB views)
• Truth Social: only prominent users (Trump, Vance, etc.) work publicly
• Instagram song reels: deprecated (endpoint exists but non-functional)
• Transcripts: all transcript endpoints require video under 2 minutes
• Reddit subreddit names: case-sensitive! Use "AskReddit" not "askreddit"