ScrapeCreators API

ScrapeCreators provides 100+ REST endpoints to scrape public data from 20+ social media platforms. One API key, one header, simple curl requests.

Quick start

Authentication

Every request needs a single header:

CODEBLOCK0

Get your key at https://scrapecreators.com (100 free credits on signup, no card required).

Store the key in an environment variable so it stays out of scripts and doesn't end up in version control or chat history:

CODEBLOCK1

Your first request

CODEBLOCK2

That's the whole pattern. Every endpoint works the same way: GET request, query parameters, one auth header.

Base URL

CODEBLOCK3

How credits work

• - Most endpoints: 1 request = 1 credit
• A few specialized endpoints cost more (e.g., audience demographics = 26 credits)
• Credits never expire, no monthly commitment
• Most responses include a credits_remaining field
• Check credit costs per endpoint in the docs: https://docs.scrapecreators.com

Common parameters

These work across most endpoints:

Pagination

Many endpoints return paginated results. The pattern is:

1. 1. Make the first request without a cursor
2. The response includes a cursor (or next_cursor or next_page_id) field
3. Pass that value as ?cursor=... in the next request
4. Repeat until cursor is null/empty

CODEBLOCK4

Some v2 endpoints require manual pagination — check the platform reference for specifics.

Supported platforms and endpoints

Each platform has its own reference file with full endpoint details. Read the relevant one based on the user's request.

Making requests: the pattern

Every call follows the same shape. Always use -G with --data-urlencode to safely pass query parameters — this prevents shell injection from user-provided values (handles, search queries, URLs) and properly encodes special characters:

CODEBLOCK5

Pipe through jq to format the JSON, or through jq '.some.field' to extract specific data. Using jq is important because raw API responses are often large nested JSON — extracting just the fields the user needs makes the output readable and keeps your context window clean.

Chaining requests

A common pattern is to fetch a profile first (to confirm the account exists and get IDs), then drill into their content:

CODEBLOCK6

Saving results

CODEBLOCK7

Processing and analyzing scraped data

After fetching data, here are common analysis patterns:

Extract key metrics

Aggregate across posts

Get video transcripts for content analysis

Search and filter

Important notes

• - Public data only — the API scrapes publicly available information. No private accounts or DMs.
• No rate limits — run as many concurrent requests as needed.
• 29-second timeout — requests that take longer will time out (AWS Lambda limit). Most complete in ~3 seconds.
• AI transcript limit — videos over 2 minutes that need AI-generated transcripts won't return transcripts. YouTube transcripts have their own dedicated endpoint and are unaffected.
• Versioned endpoints — some endpoints have moved beyond v1: TikTok profile videos is now v3 (uses max_cursor instead of cursor), TikTok video info is v2, Instagram user posts / reels search / post comments are v2. Check the platform reference files for current versions.
• Response format — all responses are JSON. Use trim=true to reduce payload size when you only need key fields.

Error handling

If a request fails:

1. 1. Check the HTTP status code
2. The response body usually contains an error message
3. Common issues: invalid API key (401), endpoint not found (404), timeout on slow requests (502/503)

CODEBLOCK12

Choosing the right endpoint

When the user describes what they need, match it to the right platform and endpoint:

• - "Get info about a creator/account" → INLINECODE32
• "Get their posts/videos/content" → /{platform}/profile/videos (TikTok) or /{platform}/channel-videos (YouTube) or /{platform}/user/posts (Instagram) or /{platform}/posts (Facebook)
• "Get comments on a post" → /{platform}/video/comments or INLINECODE38
• "Search for content about X" → /{platform}/search/keyword (TikTok) or /{platform}/search (others)
• "Get the transcript of a video" → /{platform}/video/transcript (TikTok/YouTube) or /v2/instagram/media/transcript (Instagram) or /facebook/transcript (Facebook)
• "Who follows them / who do they follow" → /{platform}/user/followers or INLINECODE45
• "What's trending" → /tiktok/videos/popular, /tiktok/get-trending-feed, INLINECODE48
• "Find ads by a company" → /facebook/adLibrary/search/ads, /linkedin/ads/search, /google/company/ads, or INLINECODE52
• "Get product details from TikTok Shop" → /tiktok/product, INLINECODE54

When in doubt, check the platform reference file for the full endpoint list.

Full API docs

For the complete interactive documentation with response schemas and playground: https://docs.scrapecreators.com