scrapecreators-api

用途

ScrapeCreators API 用于抓取和提取 27 个以上社交媒体平台的公开数据，共提供 110 个端点。它面向需要跨平台采集社交媒体公开信息的开发者与自动化流程，通过统一的 REST 接口访问各平台数据。

主要能力

用户资料：获取 TikTok、Instagram、YouTube、LinkedIn（个人与公司）、Facebook、Twitter/X、Reddit、Threads、Bluesky、Pinterest、Truth Social、Twitch、Snapchat 等平台的资料信息。
帖子与内容流：获取各平台的视频、帖子、Reels、Shorts、播放列表、照片、群组帖子等内容列表。
单条内容详情：按 URL 或 ID 获取单条视频、帖子、Pin、Clip 等的详细信息。
评论：获取 TikTok、Instagram、YouTube、Facebook、Reddit 的评论数据。
字幕/转录：支持 TikTok、Instagram、YouTube、Facebook、Twitter/X 的视频转录，所有转录端点要求视频时长在 2 分钟以内。
搜索：支持 TikTok（用户、关键词、话题标签、综合）、Instagram Reels、YouTube（含话题标签）、Reddit（全站与子版块内）、Threads（帖子与用户）、Pinterest、Google 的搜索。
广告库：支持 Facebook、Google、LinkedIn、Reddit 的广告搜索、公司广告、广告详情与广告主查找。
热门/流行内容：TikTok 热门信息流、热门视频、热门创作者、热门话题标签、热门歌曲、歌曲详情与使用该歌曲的视频；YouTube 热门 Shorts。
关注关系与直播（仅 TikTok）：关注列表、粉丝列表、受众人口统计、直播流。
TikTok Shop：商品搜索、店铺商品、商品详情、商品评价、用户橱窗。
Link-in-Bio 及其他：Linktree、Komi、Pillar、Linkbio、Linkme、Amazon Shop；Instagram 基础资料、嵌入 HTML、年龄/性别检测、额度余额查询。

使用方式

所有端点使用 GET 请求，在 URL 中传递查询参数，并通过 x-api-key 请求头认证，响应为 JSON。基础 URL 为 https://api.scrapecreators.com。API 密钥需在 https://scrapecreators.com 获取。

curl 示例：

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

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();

端点路径遵循 /v1/platform/action 模式。每个端点有独立的 OpenAPI 规范，位于 https://docs.scrapecreators.com/{path}/openapi.json，例如 https://docs.scrapecreators.com/v1/tiktok/profile/openapi.json。建议在确定要调用的端点后，先获取该端点的 OpenAPI 规范以了解完整参数、类型和示例响应，再发起实际调用。全量规范位于 https://docs.scrapecreators.com/openapi.json（文件较大，优先使用单端点规范）。

分页：分页端点会在响应中返回 cursor/token，将其作为查询参数传回即可获取下一页。不同端点使用不同的游标字段，如 cursor、max_cursor、min_time、continuationToken、after、next_max_id、max_id、page、paginationToken。

常用可选参数：

trim（布尔值）：减小响应体积，仅在需要关键指标时使用。
region（字符串）：两位国家代码，用于代理位置，不按地区过滤，仅将请求路由到该国家的代理。

额度成本：大多数端点每次请求消耗 1 个额度。例外：/v1/tiktok/user/audience 始终消耗 26 个额度；/v1/tiktok/video/transcript 在 use_ai_as_fallback=true 时额外消耗 10 个额度；/v1/google/company/ads 在 get_ad_details=true 时消耗 25 个额度。可通过 /v1/credit/balance 查询余额，调用高成本端点前应提醒用户。

适用场景

跨平台社交媒体公开数据的采集与聚合。
内容分析、趋势监测、热门内容与话题标签追踪。
广告库调研与竞品广告分析。
视频字幕/转录提取与文本分析。
TikTok Shop 商品与评价数据采集。
受众人口统计与关注关系分析（TikTok）。

限制

Handle 格式：不带 @ 符号，例如使用 charlidamelio 而非 @charlidamelio。适用于 TikTok、Instagram、Twitter、Threads、Bluesky、Snapchat、Twitch、Pinterest、Truth Social。
YouTube handle：不带 @ 符号，例如 ThePatMcAfeeShow；也可传 channelId（如 UC-9-kyTW8ZkZNDHQJ6FgpwQ）或完整 URL。
话题标签：不带 # 符号，例如使用 fyp 而非 #fyp。适用于 TikTok 和 YouTube 话题标签搜索端点。
Twitter：返回约 100 条最热门推文，而非按时间顺序或最新。
Threads：公开仅可见最近 20-30 条帖子。
Facebook 帖子：每页仅 3 条帖子（API 限制）。
Facebook 群组帖子：每页仅 3 条帖子（同一 API 限制）。
LinkedIn 公司帖子：最多 7 页。
Instagram 播放量：仅统计 IG 内播放量（不含跨平台发布到 FB 的播放量）。
Truth Social：仅知名用户（如 Trump、Vance 等）可公开访问。
Instagram 歌曲 Reels：已弃用（端点存在但不可用）。
转录：所有转录端点要求视频时长在 2 分钟以内。
Reddit 子版块名称：区分大小写，例如使用 AskReddit 而非 askreddit。

技能介绍

用途

主要能力

使用方式

适用场景

限制