Communitygithub.com

ScrapeCreators API

从27多个社交媒体平台抓取和提取公共数据。提供110个端点。

ScrapeCreators API 是什么?

ScrapeCreators API 是一个强大的工具,允许开发者从 TikTok、Instagram、YouTube、LinkedIn、Facebook、Twitter/X、Reddit、Threads、Bluesky、Pinterest、Truth Social、Twitch、Snapchat 等 27 多个社交媒体平台抓取和提取公共数据。它提供 110 个端点,涵盖个人资料/用户信息、帖子/内容提要、单条帖子/视频详情、评论、字幕、搜索、广告库、热门/流行内容、关注者/关注/直播、TikTok 商店以及链接简介/其他服务。每个端点都需要一个 API 密钥(通过 `x-api-key` 头部传递),并处理 GET 请求,返回 JSON 响应。端点路径遵循 `/v1/platform/action` 模式,每个端点都有独立的 OpenAPI 规范,可在 `https://docs.scrapecreators.com/{path}/openapi.json` 获取,帮助开发者了解完整的参数详情、类型和示例响应。该 API 支持分页(使用游标、令牌或页码),并提供可选的 `trim` 参数来减小响应负载,以及 `region` 参数用于选择代理位置。大多数端点每次请求消耗 1 个积分,但某些端点(如 TikTok 观众人口统计)消耗 26 个积分,TikTok 视频字幕(当启用 AI 回退时)额外消耗 10 个积分,Google 公司广告(当获取广告详情时)消耗 25 个积分。用户可以通过 `/v1/credit/balance` 端点检查积分余额。ScrapeCreators API 适用于多种平台,包括 Claude Code、Cursor、Codex 以及自定义 AI 代理工作流。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ScrapeCreators/social-media-research-skills/tree/main/skills/scrapecreators-api

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

ScrapeCreators API 是做什么的?

从 27 多个社交媒体平台抓取和提取公共数据。提供 110 个端点。

基础 URL: https://api.scrapecreators.com

在 https://scrapecreators.com 获取您的 API 密钥

如何调用

所有端点均使用 GET 请求。在 URL 中传递查询参数,并通过 x-api-key 头部进行身份验证。响应为 JSON。

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。下表列出了每个端点路径及其必需的参数。

API 规范

每个端点都有独立的 OpenAPI 规范,位于 https://docs.scrapecreators.com/{path}/openapi.json。

例如:https://docs.scrapecreators.com/v1/tiktok/profile/openapi.json

重要: 在通过下面的路由表确定要调用的端点后,请先获取该端点的独立 OpenAPI 规范,以了解完整的参数详情、类型和示例响应,然后再进行实际 API 调用。

涵盖所有端点的完整规范位于 https://docs.scrapecreators.com/openapi.json(文件较大 — 建议优先使用上面的每个端点规范)。

意图路由

将用户意图映射到正确的端点。选择端点后,在调用前先获取其 OpenAPI 规范(https://docs.scrapecreators.com/{path}/openapi.json)以了解完整的参数详情。

个人资料 / 用户信息

平台端点主要参数示例
TikTok/v1/tiktok/profilehandlestoolpresidente
Instagram/v1/instagram/profilehandlejane
YouTube/v1/youtube/channelhandle, channelId, 或 urlThePatMcAfeeShow
LinkedIn(个人)/v1/linkedin/profileurlhttps://www.linkedin.com/in/parrsam/
LinkedIn(公司)/v1/linkedin/companyurlhttps://linkedin.com/company/shopify
Facebook/v1/facebook/profileurlhttps://www.facebook.com/mantraindianfolsom
Twitter/X/v1/twitter/profilehandleelonmusk
Reddit/v1/reddit/subreddit/detailssubreddit 或 urlAskReddit
Threads/v1/threads/profilehandlezuck
Bluesky/v1/bluesky/profilehandlejay.bsky.team
Pinterest/v1/pinterest/user/boardshandlepinterest
Truth Social/v1/truthsocial/profilehandlerealDonaldTrump
Twitch/v1/twitch/profilehandleninja
Snapchat/v1/snapchat/profilehandledjkhaled

帖子 / 内容提要

平台端点主要参数示例
TikTok 视频/v3/tiktok/profile/videoshandlestoolpresidente
Instagram 帖子/v2/instagram/user/postshandlejane
Instagram Reels/v1/instagram/user/reelshandle 或 user_idjane 或 2700692569
Instagram 快拍高亮/v1/instagram/user/highlightshandle 或 user_idjane 或 2700692569
YouTube 视频/v1/youtube/channel/videoshandle 或 channelIdThePatMcAfeeShow
YouTube Shorts/v1/youtube/channel/shortshandle 或 channelIdstarterstory
YouTube 播放列表/v1/youtube/playlistplaylist_idPLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS
LinkedIn 帖子/v1/linkedin/company/postsurlhttps://linkedin.com/company/shopify
Facebook 帖子/v1/facebook/profile/postsurl 或 pageIdhttps://www.facebook.com/pacemorby
Facebook Reels/v1/facebook/profile/reelsurlhttps://www.facebook.com/Spurs
Facebook 照片/v1/facebook/profile/photosurlhttps://www.facebook.com/Spurs
Facebook 群组帖子/v1/facebook/group/postsurl 或 group_id742354120555345
Twitter 推文/v1/twitter/user/tweetshandleelonmusk
Reddit 帖子/v1/reddit/subredditsubredditAskReddit
Threads 帖子/v1/threads/user/postshandlezuck
Bluesky 帖子/v1/bluesky/user/postshandle 或 user_idjay.bsky.team
Truth Social 帖子/v1/truthsocial/user/postshandle 或 user_idrealDonaldTrump
Pinterest 画板/v1/pinterest/boardurlhttps://www.pinterest.com/...

单条帖子 / 视频详情

平台端点主要参数示例
TikTok/v2/tiktok/videourlhttps://www.tiktok.com/@randomspamvideos25/video/7251387037834595630
Instagram/v1/instagram/posturlhttps://www.instagram.com/reel/DOq6eV6iIgD
Instagram 快拍高亮/v1/instagram/user/highlight/detailid18067016518767507
YouTube/v1/youtube/videourlhttps://www.youtube.com/watch?v=Y2Ah_DFr8cw
YouTube 社区帖子/v1/youtube/community-posturlhttps://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8
LinkedIn/v1/linkedin/posturlhttps://www.linkedin.com/pulse/being-father-has-made-me-better-leader...
Facebook/v1/facebook/posturlhttps://www.facebook.com/reel/1535656380759655
Twitter/X/v1/twitter/tweeturlhttps://twitter.com/elonmusk/status/...
Twitter/X 社区/v1/twitter/communityurlhttps://twitter.com/i/communities/...
Twitter/X 社区推文/v1/twitter/community/tweetsurlhttps://twitter.com/i/communities/...
Reddit/v1/reddit/post/commentsurlhttps://www.reddit.com/r/AskReddit/comments/...
Threads/v1/threads/posturlhttps://www.threads.net/@zuck/post/...
Bluesky/v1/bluesky/posturlhttps://bsky.app/profile/.../post/...
Truth Social/v1/truthsocial/posturlhttps://truthsocial.com/@realDonaldTrump/posts/...
Pinterest/v1/pinterest/pinurlhttps://www.pinterest.com/pin/...
Twitch 片段/v1/twitch/clipurlhttps://clips.twitch.tv/...
Kick 片段/v1/kick/clipurlhttps://kick.com/...

评论

平台端点主要参数示例
TikTok/v1/tiktok/video/commentsurlhttps://www.tiktok.com/@stoolpresidente/video/7499229683859426602
Instagram/v2/instagram/post/commentsurlhttps://www.instagram.com/reel/DOq6eV6iIgD
YouTube/v1/youtube/video/commentsurlhttps://www.youtube.com/watch?v=dQw4w9WgXcQ
Facebook/v1/facebook/post/commentsurl 或 feedback_idhttps://www.facebook.com/reel/753347914167361
Reddit/v1/reddit/post/commentsurlhttps://www.reddit.com/r/AskReddit/comments/...

字幕

平台端点示例注意
TikTok/v1/tiktok/video/transcripturl=https://www.tiktok.com/...&lang=en也可通过 /v2/tiktok/video 使用 get_transcript=true 参数
Instagram/v2/instagram/media/transcripturl=https://www.instagram.com/reel/...AI 驱动,10-30 秒,视频长度不超过 2 分钟
YouTube/v1/youtube/video/transcripturl=https://www.youtube.com/watch?v=bjVIDXPP7Uk也包含在 /v1/youtube/video 的响应中
Facebook/v1/facebook/post/transcripturl=https://www.facebook.com/reel/...仅限长度不超过 2 分钟的视频
Twitter/X/v1/twitter/tweet/transcripturl=https://twitter.com/...AI 驱动,速度较慢

搜索

平台端点主要参数示例
TikTok 用户/v1/tiktok/search/usersqueryfunny
TikTok 视频(关键词)/v1/tiktok/search/keywordqueryfunny
TikTok 视频(话题标签)/v1/tiktok/search/hashtaghashtagfyp
TikTok 综合(照片+视频)/v1/tiktok/search/topqueryfunny
Instagram Reels/v2/instagram/reels/searchquerydogs
YouTube/v1/youtube/searchqueryfunny
YouTube 话题标签/v1/youtube/search/hashtaghashtagfunny
Reddit(全局)/v1/reddit/searchquerybest programming languages
Reddit(子版块内)/v1/reddit/subreddit/searchsubreddit + queryAskReddit + funny
Threads 帖子/v1/threads/searchqueryAI
Threads 用户/v1/threads/search/usersqueryzuck
Pinterest/v1/pinterest/searchqueryhome decor
Google/v1/google/searchquerybest restaurants in NYC

广告库

平台端点主要参数示例
Facebook 广告搜索/v1/facebook/adLibrary/search/adsqueryrunning
Facebook 公司广告/v1/facebook/adLibrary/company/adspageId 或 companyNameLululemon
Facebook 广告详情/v1/facebook/adLibrary/adid 或 url702369045530963
Facebook 查找公司/v1/facebook/adLibrary/search/companiesqueryNike
Google 公司广告/v1/google/company/adsdomain 或 advertiser_idnike.com
Google 广告详情/v1/google/adurlhttps://adstransparency.google.com/...
Google 查找广告主/v1/google/adLibrary/advertisers/searchqueryNike
LinkedIn 广告搜索/v1/linkedin/ads/searchcompany 或 keywordShopify
LinkedIn 广告详情/v1/linkedin/adurlhttps://www.linkedin.com/ad/...
Reddit 广告搜索/v1/reddit/ads/searchquerygaming
Reddit 广告详情/v1/reddit/adidt3_abc123

热门 / 流行内容

内容端点参数示例
热门 Feed/v1/tiktok/get-trending-feedregion(必需)US
热门视频/v1/tiktok/videos/popular
热门创作者/v1/tiktok/creators/popular
热门话题标签/v1/tiktok/hashtags/popular
热门歌曲/v1/tiktok/songs/popular
歌曲详情/v1/tiktok/songclipId7439295283975702544
使用该歌曲的视频/v1/tiktok/song/videosclipId7439295283975702544
热门 Shorts(YT)/v1/youtube/shorts/trending

关注者 / 关注 / 直播(仅限 TikTok)

类型端点示例
正在关注/v1/tiktok/user/followinghandle=stoolpresidente
关注者/v1/tiktok/user/followershandle=stoolpresidente
观众人口统计/v1/tiktok/user/audience(26 积分!)handle=shakira
直播流/v1/tiktok/user/livehandle=thejustalex

TikTok 店铺

类型端点主要参数示例
搜索商品/v1/tiktok/shop/searchqueryshoes
店铺商品/v1/tiktok/shop/productsurlhttps://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079
商品详情/v1/tiktok/producturlhttps://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies.../1729587769570529799
商品评论/v1/tiktok/shop/product/reviewsurl 或 product_id1731578642912612516
用户展示柜/v1/tiktok/user/showcasehandlemrtiktokreviews

链接简介 / 其他

服务端点参数示例
Linktree/v1/linktreeurlhttps://linktr.ee/...
Komi/v1/komiurlhttps://komi.io/...
Pillar/v1/pillarurlhttps://pillar.io/...
Linkbio/v1/linkbiourlhttps://linkbio.co/...
Linkme/v1/linkmeurlhttps://linkme.bio/...
Amazon 店铺/v1/amazon/shopurlhttps://www.amazon.com/shop/...
Instagram 基本资料/v1/instagram/basic/profileuserId314216
Instagram 嵌入 HTML/v1/instagram/user/embedhandlejane
年龄/性别检测/v1/detect/age-genderurl(社交资料)https://www.tiktok.com/@charlidamelio
积分余额/v1/credit/balance(无)

积分成本

大多数端点每次请求消耗 1 积分。例外情况:

端点成本条件
/v1/tiktok/user/audience26 积分始终
/v1/tiktok/video/transcript+10 积分当 use_ai_as_fallback=true 时
/v1/google/company/ads25 积分当 get_ad_details=true 时

通过 /v1/credit/balance 检查余额。在调用高成本端点前警告用户。

分页

分页端点在响应中返回一个游标/令牌。将其作为查询参数传递以获取下一页。

游标字段使用对象
cursorTikTok 评论/搜索/歌曲视频、Instagram 评论、Reddit 子版块搜索、Pinterest、Bluesky、Facebook Reels/照片/帖子/评论、TikTok 店铺商品/用户展示柜
max_cursorTikTok 个人资料视频
min_timeTikTok 关注/关注者
continuationTokenYouTube(所有分页端点)
afterReddit 帖子、Reddit 搜索
next_max_idInstagram 帖子、Truth Social 帖子
max_idInstagram Reels
pageTikTok 热门/店铺、Instagram Reels 搜索、LinkedIn 公司帖子、TikTok 店铺评论
paginationTokenLinkedIn 广告

常用可选参数

  • trim(布尔值):减少响应负载大小。当只需要关键指标时使用。
  • region(字符串):用于代理位置的两位国家代码。不会按地区过滤——仅将请求路由到该国家的代理。

已知限制

  • 用户名:传递时不要带 @ 符号。使用 charlidamelio 而不是 @charlidamelio。适用于 TikTok、Instagram、Twitter、Threads、Bluesky、Snapchat、Twitch、Pinterest、Truth Social。
  • YouTube 用户名:传递时不要带 @ 符号。使用 ThePatMcAfeeShow 而不是 @ThePatMcAfeeShow。也可以传递 channelId(例如 UC-9-kyTW8ZkZNDHQJ6FgpwQ)或完整 URL。
  • 话题标签:传递时不要带 # 符号。使用 fyp 而不是 #fyp。适用于 TikTok。

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

ad-library-teardown

Use when the user wants to analyze active ads from Meta/Facebook, Google, or LinkedIn ad libraries; tear down a competitor

audience-research

Use when the user wants to evaluate a creator, influencer, or brand audience using public profile signals, TikTok audience demographics, follower/following data, comments, geography, language, and content fit. Helps judge sponsorship and market fit.

comment-mining

Use when the user wants to mine comments and replies for audience reactions, customer language, questions, objections, complaints, product ideas, buying intent, sentiment, or voice-of-customer insights from public social posts and videos.

competitor-social-research

Use when the user wants to research competitors

content-repurposing

Use when the user wants to turn public social videos, transcripts, posts, or creator research into reusable content assets such as LinkedIn posts, X threads, short-form scripts, newsletters, blog outlines, carousels, or content calendars.

creator-profile-teardown

Use when the user wants to analyze a creator, influencer, founder, or brand social account and understand positioning, content pillars, outlier posts, hooks, format choices, audience reaction, and what can be copied or tested.

influencer-prospecting

Use when the user wants to find creators, influencers, affiliates, or social accounts in a niche for outreach, partnerships, sponsorships, UGC, seeding, or competitive research. Produces scored prospect lists from public social data.

outlier-post-finder

Use when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline. Finds outliers, explains why they worked, extracts hooks and formats, and produces a practical swipe file.

product-demand-research

Use when the user wants to validate a product idea, find pain points, mine demand signals, discover objections, or gather voice-of-customer language from Reddit, social posts, video transcripts, and comments. Produces evidence-backed product research.

social-listening-brief

Use when the user wants a social listening report about what people are saying about a brand, person, product, topic, category, or niche across public social platforms. Produces cited themes, sentiment caveats, notable posts, and recommended actions.

transcript-intelligence

Use when the user wants to summarize, analyze, or repurpose transcripts from TikTok, Instagram, YouTube, Facebook, X/Twitter, LinkedIn, Rumble, or Reddit video posts. Extracts hooks, claims, quotes, content atoms, themes, and reusable scripts.

trend-discovery

Use when the user wants to discover trending social topics, hashtags, sounds, posts, reels, shorts, creators, or formats in a niche. Searches public trend and discovery endpoints, ranks evidence, and turns trends into practical content angles.

相关技能