$npx -y skills add ScrapeCreators/social-media-research-skills --skill scrapecreators-apiScrape 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 serv
| 1 | # ScrapeCreators API |
| 2 | |
| 3 | Scrape and extract public data from 27+ social media platforms. 110 endpoints available. |
| 4 | |
| 5 | **Base URL:** `https://api.scrapecreators.com` |
| 6 | |
| 7 | Get your API key at https://scrapecreators.com |
| 8 | |
| 9 | ## How to Call |
| 10 | |
| 11 | All endpoints use GET requests. Pass query params in the URL and authenticate with the `x-api-key` header. Responses are JSON. |
| 12 | |
| 13 | ```bash |
| 14 | curl -s "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio" \ |
| 15 | -H "x-api-key: $SCRAPECREATORS_API_KEY" |
| 16 | ``` |
| 17 | |
| 18 | Or with `fetch`: |
| 19 | |
| 20 | ```javascript |
| 21 | const res = await fetch( |
| 22 | "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio", |
| 23 | { headers: { "x-api-key": process.env.SCRAPECREATORS_API_KEY } } |
| 24 | ); |
| 25 | const data = await res.json(); |
| 26 | ``` |
| 27 | |
| 28 | Endpoint paths use the pattern `/v1/platform/action`. The tables below list each endpoint path and its required params. |
| 29 | |
| 30 | ### API Spec |
| 31 | |
| 32 | Each endpoint has its own OpenAPI spec at `https://docs.scrapecreators.com/{path}/openapi.json`. |
| 33 | |
| 34 | For example: https://docs.scrapecreators.com/v1/tiktok/profile/openapi.json |
| 35 | |
| 36 | **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. |
| 37 | |
| 38 | The full spec covering all endpoints is at https://docs.scrapecreators.com/openapi.json (large file — prefer the per-endpoint specs above). |
| 39 | |
| 40 | ## Intent Routing |
| 41 | |
| 42 | 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. |
| 43 | |
| 44 | ### Profiles / User Info |
| 45 | | Platform | Endpoint | Primary Param | Example | |
| 46 | |----------|----------|---------------|---------| |
| 47 | | TikTok | `/v1/tiktok/profile` | handle | `stoolpresidente` | |
| 48 | | Instagram | `/v1/instagram/profile` | handle | `jane` | |
| 49 | | YouTube | `/v1/youtube/channel` | handle, channelId, or url | `ThePatMcAfeeShow` | |
| 50 | | LinkedIn (person) | `/v1/linkedin/profile` | url | `https://www.linkedin.com/in/parrsam/` | |
| 51 | | LinkedIn (company) | `/v1/linkedin/company` | url | `https://linkedin.com/company/shopify` | |
| 52 | | Facebook | `/v1/facebook/profile` | url | `https://www.facebook.com/mantraindianfolsom` | |
| 53 | | Twitter/X | `/v1/twitter/profile` | handle | `elonmusk` | |
| 54 | | Reddit | `/v1/reddit/subreddit/details` | subreddit or url | `AskReddit` | |
| 55 | | Threads | `/v1/threads/profile` | handle | `zuck` | |
| 56 | | Bluesky | `/v1/bluesky/profile` | handle | `jay.bsky.team` | |
| 57 | | Pinterest | `/v1/pinterest/user/boards` | handle | `pinterest` | |
| 58 | | Truth Social | `/v1/truthsocial/profile` | handle | `realDonaldTrump` | |
| 59 | | Twitch | `/v1/twitch/profile` | handle | `ninja` | |
| 60 | | Snapchat | `/v1/snapchat/profile` | handle | `djkhaled` | |
| 61 | |
| 62 | ### Posts / Content Feeds |
| 63 | | Platform | Endpoint | Primary Param | Example | |
| 64 | |----------|----------|---------------|---------| |
| 65 | | TikTok videos | `/v3/tiktok/profile/videos` | handle | `stoolpresidente` | |
| 66 | | Instagram posts | `/v2/instagram/user/posts` | handle | `jane` | |
| 67 | | Instagram reels | `/v1/instagram/user/reels` | handle or user_id | `jane` or `2700692569` | |
| 68 | | Instagram highlights | `/v1/instagram/user/highlights` | handle or user_id | `jane` or `2700692569` | |
| 69 | | YouTube videos | `/v1/youtube/channel/videos` | handle or channelId | `ThePatMcAfeeShow` | |
| 70 | | YouTube shorts | `/v1/youtube/channel/shorts` | handle or channelId | `starterstory` | |
| 71 | | YouTube playlist | `/v1/youtube/playlist` | playlist_id | `PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS` | |
| 72 | | LinkedIn posts | `/v1/linkedin/company/posts` | url | `https://linkedin.com/company/shopify` | |
| 73 | | Facebook posts | `/v1/facebook/profile/posts` |