Scrapecreators API Skill for Cursor

>- Scrape and extract public data from 27+ social media platforms using the ScrapeCreators REST API. Covers TikTok, Instagram, YouTube, LinkedIn, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, Snapchat, Twitch, Kick, Truth Social, TikTok Shop, Google, and link-in-bio services (Linktree, Komi, Pillar, Linkbio, Linkme, Amazon Shop). Use when the user asks to scrape, fetch, extract, search, or look up social media profiles, posts, videos, reels, comments, transcripts, followers, ads, hashtags, trending content, or engagement metrics from any social platform. Also use when user mentions ScrapeCreators, social media API, ad library, or creator data.

4k tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

1780

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/ScrapeCreators/social-media-research-skills --skill scrapecreators-api

What it tells the agent to use

found in the instruction text

Bash runs shell commands — read the instruction before connecting

WebFetch fetches pages from the network

The instruction itself

19 sections, as written by the author

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

|----------|----------|---------------|---------|

| Instagram highlight | /v1/instagram/user/highlight/detail | id | 18067016518767507 |

Comments

|----------|----------|---------------|---------|

Transcripts

|----------|----------|---------|------|

Search

|----------|----------|---------------|---------|

Ad Libraries

|----------|----------|---------------|---------|

|---------|----------|-------|---------|

Followers / Following / Live (TikTok only)

| Type | Endpoint | Example |

|------|----------|---------|

| Following | /v1/tiktok/user/following | handle=stoolpresidente |

| Followers | /v1/tiktok/user/followers | handle=stoolpresidente |

| Audience demographics | /v1/tiktok/user/audience (26 credits!) | handle=shakira |

| Live stream | /v1/tiktok/user/live | handle=thejustalex |

TikTok Shop

|------|----------|---------------|---------|

Link-in-Bio / Other

|---------|----------|-------|---------|

Credit Costs

Most endpoints cost 1 credit per request. Exceptions:

| Endpoint | Cost | Condition |

|----------|------|-----------|

| /v1/tiktok/user/audience | 26 credits | always |

| /v1/tiktok/video/transcript | +10 credits | when use_ai_as_fallback=true |

| /v1/google/company/ads | 25 credits | when get_ad_details=true |

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.

| Cursor Field | Used By |

|-------------|---------|

| cursor | TikTok comments/search/song videos, Instagram comments, Reddit subreddit search, Pinterest, Bluesky, Facebook reels/photos/posts/comments, TikTok Shop products/user showcase |

| max_cursor | TikTok profile videos |

| min_time | TikTok following/followers |

| continuationToken | YouTube (all paginated endpoints) |

| after | Reddit posts, Reddit search |

| next_max_id | Instagram posts, Truth Social posts |

| max_id | Instagram reels |

| page | TikTok popular/shop, Instagram reels search, LinkedIn company posts, TikTok Shop reviews |

| paginationToken | LinkedIn ads |

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"

How to use it

Copy the folder

Take scrapecreators/scrapecreators-api from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Scrapecreators API Skill for Cursor

Install

What it tells the agent to use

The instruction itself

ScrapeCreators API

How to Call

API Spec

Intent Routing

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

Pagination

Common Optional Params

Known Limitations

How to use it