Getting Started

ScrapeCreators is a REST API that scrapes public data from 27+ social and creator platforms. One auth header, one base URL, one credit per call for most endpoints.

Base URL

https://api.scrapecreators.com

Authentication

Pass your API key in the x-api-key header on every request.

curl 'https://api.scrapecreators.com/v1/tiktok/profile?handle=stoolpresidente' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Get a key at scrapecreators.com. Mike keeps his key in D:\Ecosystem\secrets\MASTER_API_KEYS.env under SCRAPECREATORS_API_KEY. Reference it as $SCRAPECREATORS_API_KEY in shell, process.env.SCRAPECREATORS_API_KEY in Node, or os.environ['SCRAPECREATORS_API_KEY'] in Python.

Quickstart

curl

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

Node / TypeScript

const res = await fetch(
  'https://api.scrapecreators.com/v1/tiktok/profile?handle=stoolpresidente',
  { headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY } }
);
const data = await res.json();
console.log(data.user.nickname, data.stats.followerCount);

Python

import os, requests

r = requests.get(
    'https://api.scrapecreators.com/v1/tiktok/profile',
    headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
    params={'handle': 'stoolpresidente'},
)
r.raise_for_status()
data = r.json()
print(data['user']['nickname'], data['stats']['followerCount'])

CLI

If you have the scrapecreators CLI installed, every endpoint maps to a subcommand:

scrapecreators tiktok profile --handle stoolpresidente
scrapecreators instagram profile --handle natgeo
scrapecreators youtube channel --handle veritasium

Credits

Most endpoints cost 1 credit per successful response. Heavier endpoints (AI transcripts, ad detail lookups, certain enrichment calls) may cost more. Check the per-endpoint page for exact pricing notes.

Check your remaining balance any time:

curl 'https://api.scrapecreators.com/v1/credit-balance' \
  -H "x-api-key: $SCRAPECREATORS_API_KEY"

Status Codes

Status	Meaning	What To Do
200	Success.	Parse the JSON.
400	Invalid or missing parameter.	Check required params and value format.
401	Missing or invalid x-api-key.	Verify the header is present and the key is active.
402	Out of credits.	Top up at scrapecreators.com or wait for plan reset.
404	Resource not found or private.	Confirm the handle, URL, or id and that the resource is public.
429	Rate limited.	Backoff and retry with exponential delay.
500	Server error or upstream platform failure.	Retry with backoff. Report persistent failures to support.

Rate Limiting

ScrapeCreators is plan-based. Most requests complete in 1 to 5 seconds, though scraping-heavy endpoints (full follower lists, large video transcripts) can take longer. Treat the API as I/O bound and run requests in parallel with a small concurrency cap (4 to 10 workers is a safe default).

Pagination

Many list endpoints use cursor-based pagination. Look for a cursor, next_cursor, or nextMaxId field in the response and pass it back on the next call with the matching query parameter (often cursor or max_id). Each platform's endpoint page documents the exact cursor name.

Versions

Most endpoints live under /v1/. A few have /v2/ or /v3/ variants that return richer or paginated data. Always check the path on the endpoint page. The newest version is generally preferred when available.

Need Help

• Open the per-endpoint pages in the sidebar for parameters, examples, and response shapes.
• Use the chat widget in the bottom right for natural-language lookups across the entire API.
• Check the Utility section for usage analytics and credit balance.