scrapecreators-api
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseScrapeCreators API
ScrapeCreators API
Scrape and extract public data from 27+ social media platforms. 110 endpoints available.
Base URL:
https://api.scrapecreators.comGet your API key at https://scrapecreators.com
从27+社交媒体平台爬取并提取公开数据。提供110个可用端点。
基础URL:
https://api.scrapecreators.com获取API密钥请访问https://scrapecreators.com
How to Call
调用方式
All endpoints use GET requests. Pass query params in the URL and authenticate with the header. Responses are JSON.
x-api-keybash
curl -s "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio" \
-H "x-api-key: $SCRAPECREATORS_API_KEY"Or with :
fetchjavascript
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 . The tables below list each endpoint path and its required params.
/v1/platform/action所有端点均使用GET请求。在URL中传递查询参数，并通过请求头进行身份验证。响应格式为JSON。
x-api-keybash
curl -s "https://api.scrapecreators.com/v1/tiktok/profile?handle=charlidamelio" \
-H "x-api-key: $SCRAPECREATORS_API_KEY"或者使用:
fetchjavascript
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();端点路径采用格式。下方表格列出了每个端点的路径及其必填参数。
/v1/platform/actionAPI Spec
API规范
Each endpoint has its own OpenAPI spec at .
https://docs.scrapecreators.com/{path}/openapi.jsonImportant: 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).
每个端点都有对应的OpenAPI规范，地址为。
https://docs.scrapecreators.com/{path}/openapi.json重要提示: 从下方路由表确定要调用的端点后，请先获取该端点的OpenAPI规范，以了解完整的参数细节、类型和示例响应，再发起实际API调用。
Intent Routing
意图路由
Map user intent to the right endpoint. After selecting an endpoint, fetch its OpenAPI spec at for full param details before calling.
https://docs.scrapecreators.com/{path}/openapi.json将用户意图映射到对应的端点。选择端点后，先获取其位于的OpenAPI规范，了解完整参数细节后再调用。
https://docs.scrapecreators.com/{path}/openapi.jsonProfiles / User Info
个人主页/用户信息
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok | | handle | |
| handle | | |
| YouTube | | handle, channelId, or url | |
| LinkedIn (person) | | url | |
| LinkedIn (company) | | url | |
| url | | |
| Twitter/X | | handle | |
| subreddit or url | | |
| Threads | | handle | |
| Bluesky | | handle | |
| handle | | |
| Truth Social | | handle | |
| Twitch | | handle | |
| Snapchat | | handle | |
| 平台 | 端点 | 主要参数 | 示例 |
|---|---|---|---|
| TikTok | | handle | |
| handle | | |
| YouTube | | handle、channelId或url | |
| LinkedIn（个人） | | url | |
| LinkedIn（企业） | | url | |
| url | | |
| Twitter/X | | handle | |
| subreddit或url | | |
| Threads | | handle | |
| Bluesky | | handle | |
| handle | | |
| Truth Social | | handle | |
| Twitch | | handle | |
| Snapchat | | handle | |
Posts / Content Feeds
帖子/内容信息流
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok videos | | handle | |
| Instagram posts | | handle | |
| Instagram reels | | handle or user_id | |
| Instagram highlights | | handle or user_id | |
| YouTube videos | | handle or channelId | |
| YouTube shorts | | handle or channelId | |
| YouTube playlist | | playlist_id | |
| LinkedIn posts | | url | |
| Facebook posts | | url or pageId | |
| Facebook reels | | url | |
| Facebook photos | | url | |
| Facebook group posts | | url or group_id | |
| Twitter tweets | | handle | |
| Reddit posts | | subreddit | |
| Threads posts | | handle | |
| Bluesky posts | | handle or user_id | |
| Truth Social posts | | handle or user_id | |
| Pinterest board | | url | |
| 平台 | 端点 | 主要参数 | 示例 |
|---|---|---|---|
| TikTok视频 | | handle | |
| Instagram帖子 | | handle | |
| Instagram Reels | | handle或user_id | |
| Instagram高光时刻 | | handle或user_id | |
| YouTube视频 | | handle或channelId | |
| YouTube Shorts | | handle或channelId | |
| YouTube播放列表 | | playlist_id | |
| LinkedIn帖子 | | url | |
| Facebook帖子 | | url或pageId | |
| Facebook Reels | | url | |
| Facebook照片 | | url | |
| Facebook群组帖子 | | url或group_id | |
| Twitter推文 | | handle | |
| Reddit帖子 | | subreddit | |
| Threads帖子 | | handle | |
| Bluesky帖子 | | handle或user_id | |
| Truth Social帖子 | | handle或user_id | |
| Pinterest画板 | | url | |
Single Post / Video Details
单条帖子/视频详情
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok | | url | |
| url | | |
| Instagram highlight | | id | |
| YouTube | | url | |
| YouTube community post | | url | |
| url | | |
| url | | |
| Twitter/X | | url | |
| Twitter/X community | | url | |
| Twitter/X community tweets | | url | |
| url | | |
| Threads | | url | |
| Bluesky | | url | |
| Truth Social | | url | |
| url | | |
| Twitch clip | | url | |
| Kick clip | | url | |
| 平台 | 端点 | 主要参数 | 示例 |
|---|---|---|---|
| TikTok | | url | |
| url | | |
| Instagram高光时刻详情 | | id | |
| YouTube | | url | |
| YouTube社区帖子 | | url | |
| url | | |
| url | | |
| Twitter/X | | url | |
| Twitter/X社区 | | url | |
| Twitter/X社区推文 | | url | |
| url | | |
| Threads | | url | |
| Bluesky | | url | |
| Truth Social | | url | |
| url | | |
| Twitch片段 | | url | |
| Kick片段 | | url | |
Comments
评论
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok | | url | |
| url | | |
| YouTube | | url | |
| url or feedback_id | | |
| url | |
| 平台 | 端点 | 主要参数 | 示例 |
|---|---|---|---|
| TikTok | | url | |
| url | | |
| YouTube | | url | |
| url或feedback_id | | |
| url | |
Transcripts
字幕
| Platform | Endpoint | Example | Note |
|---|---|---|---|
| TikTok | | | also via |
| | AI-powered, 10-30s, under 2min | |
| YouTube | | | also included in |
| | under 2min only | |
| Twitter/X | | | AI-powered, slow |
| 平台 | 端点 | 示例 | 说明 |
|---|---|---|---|
| TikTok | | | 也可通过 |
| | AI驱动，耗时10-30秒，仅支持2分钟以内视频 | |
| YouTube | | | 也包含在 |
| | 仅支持2分钟以内视频 | |
| Twitter/X | | | AI驱动，速度较慢 |
Search
搜索
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| TikTok users | | query | |
| TikTok videos (keyword) | | query | |
| TikTok videos (hashtag) | | hashtag | |
| TikTok top (photos+videos) | | query | |
| Instagram reels | | query | |
| YouTube | | query | |
| YouTube hashtag | | hashtag | |
| Reddit (all) | | query | |
| Reddit (in subreddit) | | subreddit + query | |
| Threads posts | | query | |
| Threads users | | query | |
| query | | |
| query | |
| 平台 | 端点 | 主要参数 | 示例 |
|---|---|---|---|
| TikTok用户 | | query | |
| TikTok视频（关键词） | | query | |
| TikTok视频（话题标签） | | hashtag | |
| TikTok热门内容（图片+视频） | | query | |
| Instagram Reels | | query | |
| YouTube | | query | |
| YouTube话题标签 | | hashtag | |
| Reddit（全站） | | query | |
| Reddit（子版块内） | | subreddit + query | |
| Threads帖子 | | query | |
| Threads用户 | | query | |
| query | | |
| query | |
Ad Libraries
广告库
| Platform | Endpoint | Primary Param | Example |
|---|---|---|---|
| Facebook ads search | | query | |
| Facebook company ads | | pageId or companyName | |
| Facebook ad detail | | id or url | |
| Facebook find companies | | query | |
| Google company ads | | domain or advertiser_id | |
| Google ad detail | | url | |
| Google find advertisers | | query | |
| LinkedIn ads search | | company or keyword | |
| LinkedIn ad detail | | url | |
| Reddit ads search | | query | |
| Reddit ad detail | | id | |
| 平台 | 端点 | 主要参数 | 示例 |
|---|---|---|---|
| Facebook广告搜索 | | query | |
| Facebook企业广告 | | pageId或companyName | |
| Facebook广告详情 | | id或url | |
| Facebook企业查找 | | query | |
| Google企业广告 | | domain或advertiser_id | |
| Google广告详情 | | url | |
| Google广告主查找 | | query | |
| LinkedIn广告搜索 | | company或keyword | |
| LinkedIn广告详情 | | url | |
| Reddit广告搜索 | | query | |
| Reddit广告详情 | | id | |
Trending / Popular
热门/流行内容
| Content | Endpoint | Param | Example |
|---|---|---|---|
| Trending feed | | region (required) | |
| Popular videos | | ||
| Popular creators | | ||
| Popular hashtags | | ||
| Popular songs | | ||
| Song details | | clipId | |
| Videos using song | | clipId | |
| Trending shorts (YT) | |
| 内容类型 | 端点 | 参数 | 示例 |
|---|---|---|---|
| 热门信息流 | | region（必填） | |
| 热门视频 | | ||
| 热门创作者 | | ||
| 热门话题标签 | | ||
| 热门歌曲 | | ||
| 歌曲详情 | | clipId | |
| 使用该歌曲的视频 | | clipId | |
| 热门Shorts（YouTube） | |
Followers / Following / Live (TikTok only)
粉丝/关注列表/直播（仅TikTok）
| Type | Endpoint | Example |
|---|---|---|
| Following | | |
| Followers | | |
| Audience demographics | | |
| Live stream | | |
| 类型 | 端点 | 示例 |
|---|---|---|
| 关注列表 | | |
| 粉丝列表 | | |
| 受众 demographics | | |
| 直播流 | | |
TikTok Shop
TikTok Shop
| Type | Endpoint | Primary Param | Example |
|---|---|---|---|
| Search products | | query | |
| Store products | | url | |
| Product detail | | url | |
| Product reviews | | url or product_id | |
| User showcase | | handle | |
| 类型 | 端点 | 主要参数 | 示例 |
|---|---|---|---|
| 商品搜索 | | query | |
| 店铺商品 | | url | |
| 商品详情 | | url | |
| 商品评论 | | url或product_id | |
| 用户橱窗 | | handle | |
Link-in-Bio / Other
链接聚合/其他服务
| Service | Endpoint | Param | Example |
|---|---|---|---|
| Linktree | | url | |
| Komi | | url | |
| Pillar | | url | |
| Linkbio | | url | |
| Linkme | | url | |
| Amazon Shop | | url | |
| Instagram basic profile | | userId | |
| Instagram embed HTML | | handle | |
| Age/Gender detect | | url (social profile) | |
| Credit balance | | (none) |
| 服务 | 端点 | 参数 | 示例 |
|---|---|---|---|
| Linktree | | url | |
| Komi | | url | |
| Pillar | | url | |
| Linkbio | | url | |
| Linkme | | url | |
| Amazon Shop | | url | |
| Instagram基础个人主页 | | userId | |
| Instagram嵌入HTML | | handle | |
| 年龄/性别检测 | | url（社交主页） | |
| 积分余额 | | 无 |
Credit Costs
积分消耗
Most endpoints cost 1 credit per request. Exceptions:
| Endpoint | Cost | Condition |
|---|---|---|
| 26 credits | always |
| +10 credits | when |
| 25 credits | when |
Check balance with . Warn users before calling expensive endpoints.
/v1/credit/balance大多数端点每次请求消耗1积分。例外情况：
| 端点 | 消耗积分 | 条件 |
|---|---|---|
| 26积分 | 始终 |
| +10积分 | 当 |
| 25积分 | 当 |
调用查询余额。调用高消耗端点前请提醒用户。
/v1/credit/balancePagination
分页
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 |
|---|---|
| TikTok comments/search/song videos, Instagram comments, Reddit subreddit search, Pinterest, Bluesky, Facebook reels/photos/posts/comments, TikTok Shop products/user showcase |
| TikTok profile videos |
| TikTok following/followers |
| YouTube (all paginated endpoints) |
| Reddit posts, Reddit search |
| Instagram posts, Truth Social posts |
| Instagram reels |
| TikTok popular/shop, Instagram reels search, LinkedIn company posts, TikTok Shop reviews |
| LinkedIn ads |
支持分页的端点会在响应中返回cursor/token。将其作为查询参数传递即可获取下一页数据。
| 游标字段 | 适用端点 |
|---|---|
| TikTok评论/搜索/歌曲视频、Instagram评论、Reddit子版块搜索、Pinterest、Bluesky、Facebook Reels/照片/帖子/评论、TikTok Shop商品/用户橱窗 |
| TikTok主页视频 |
| TikTok关注/粉丝列表 |
| YouTube（所有分页端点） |
| Reddit帖子、Reddit搜索 |
| Instagram帖子、Truth Social帖子 |
| Instagram Reels |
| TikTok热门/Shop、Instagram Reels搜索、LinkedIn企业帖子、TikTok Shop评论 |
| LinkedIn广告 |
Common Optional Params
通用可选参数
- (boolean): reduces response payload size. Use when you only need key metrics.
trim - (string): 2-letter country code for proxy location. Does NOT filter by region -- just routes the request through that country's proxy.
region
- （布尔值）：减小响应 payload 大小。仅需关键指标时使用。
trim - （字符串）：代理位置的两位国家代码。不会按地区过滤内容——仅将请求路由至对应国家的代理。
region
Known Limitations
已知限制
- Handles: pass without the symbol. Use
@notcharlidamelio. Applies to TikTok, Instagram, Twitter, Threads, Bluesky, Snapchat, Twitch, Pinterest, Truth Social@charlidamelio - YouTube handles: pass without the symbol. Use
@notThePatMcAfeeShow. You can also pass a channelId (e.g.@ThePatMcAfeeShow) or full URL insteadUC-9-kyTW8ZkZNDHQJ6FgpwQ - Hashtags: pass without the symbol. Use
#notfyp. Applies to TikTok and YouTube hashtag search endpoints#fyp - 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"
- Handle：传递时不要带符号。使用
@而非charlidamelio。适用于TikTok、Instagram、Twitter、Threads、Bluesky、Snapchat、Twitch、Pinterest、Truth Social@charlidamelio - YouTube Handle：传递时不要带符号。使用
@而非ThePatMcAfeeShow。也可传递channelId（例如@ThePatMcAfeeShow）或完整URLUC-9-kyTW8ZkZNDHQJ6FgpwQ - 话题标签：传递时不要带符号。使用
#而非fyp。适用于TikTok和YouTube话题标签搜索端点#fyp - Twitter：仅返回约100条最热门推文，而非按时间顺序的最新推文
- Threads：仅能获取公开可见的最近20-30条帖子
- Facebook帖子：每页仅返回3条帖子（API限制）
- Facebook群组帖子：每页仅返回3条帖子（相同API限制）
- LinkedIn企业帖子：最多支持7页
- Instagram播放量：仅统计Instagram平台内的播放量（不包含跨平台发布到Facebook的播放量）
- Truth Social：仅公开知名用户（如特朗普、万斯等）的数据可正常获取
- Instagram歌曲Reels：已废弃（端点存在但无法正常使用）
- 字幕：所有字幕端点仅支持2分钟以内的视频
- Reddit子版块名称：区分大小写！使用"AskReddit"而非"askreddit"