ScrapeCreators API 是一个“provider skill”(提供方技能),用于在需要结构化公开社交或广告库数据、且普通网页搜索难以满足规模的场景下,通过统一操作调用 ScrapeCreators 的接口采集数据。
主要用途 用于采集主流社交平台的公开资料,包括公开主页、帖子、评论、转录文本、趋势内容,以及广告库数据。资料指出,当工作流需要结构化公开社交或广告库数据,且规模超出普通网页搜索能力时使用它。它本身是提供方技能,资料明确要求:不要在输出 API 结果后就停止,而应把控制权交回请求数据的研究技能。
主要能力与端点族 资料给出的端点族包括:
- Instagram:主页、帖子、评论,如 /v1/instagram/profile、/v2/instagram/user/posts、/v1/instagram/post、/v2/instagram/post/comments
- TikTok:主页、帖子、搜索、趋势,如 /v1/tiktok/profile、/v3/tiktok/profile/videos、/v2/tiktok/video、/v1/tiktok/search/hashtag、/v1/tiktok/get-trending-feed
- YouTube:视频、频道、转录、评论,如 /v1/youtube/video、/v1/youtube/channel、/v1/youtube/video/transcript、/v1/youtube/video/comments
- X(Twitter):主页、帖子、帖子详情,如 /v1/twitter/profile、/v1/twitter/user-tweets、/v1/twitter/tweet
- LinkedIn:个人资料、公司、帖子、广告,如 /v1/linkedin/profile、/v1/linkedin/company、/v1/linkedin/post、/v1/linkedin/ads/search
- Meta 广告库:/v1/facebook/adLibrary/search/ads、/v1/facebook/adLibrary/ad
- TikTok 广告库:当前搜索与广告详情操作需从官方 OpenAPI 解析
- Google 广告主广告:/v1/google/company/ads、/v1/google/ad 此外,TikTok Shop 商品、评论与创作者展示,Instagram 与 YouTube 的发现(Reel、音频、Shorts、话题标签、搜索、趋势),Reddit / Threads / Bluesky / Pinterest 研究(搜索、主页、帖子、评论、看板、pin),以及公开创作者链接与商店(Linktree、Komi、Pillar、Linkbio、Linkme、Amazon Shop)等操作,均需从官方 OpenAPI 解析当前对应端点。
使用方式 资料说明每个请求是一种环境无关的操作,包含 provider、method、path,以及可选的 query 或 body,并按以下优先级选择运行时执行:
- 已有 GooseWorks MCP:检查并调用实时的 call_data_provider 工具,直接传入操作字段。这是 ChatGPT、Cowork 及任何无终端客户端的首选路径,使用第一方 GooseWorks ScrapeCreators 代理与托管密钥,不经过 Orthogonal。
- 已有本地 GooseWorks CLI:将操作转换为 gooseworks call <provider> <path>,并补充 method、query 或 body 选项,使用同一第一方代理。
- 拥有用户自有的 ScrapeCreators 密钥:请求 https://api.scrapecreators.com<path>,在 x-api-key 头中携带 SCRAPECREATORS_API_KEY,并使用操作的 method、query 与 JSON body。
- 无可用运行时:请用户连接 GooseWorks MCP、登录本地 GooseWorks CLI,或提供自己的 ScrapeCreators 密钥;资料明确要求不得假装操作已执行。 资料还要求:只要 call_data_provider 已注册就优先使用 MCP,即使可能存在 shell;当托管 MCP 或 CLI 路径可用时,绝不索要单独的提供方密钥;绝不打印、存储或返回任何凭证。多数操作为 GET 请求;官方 OpenAPI 目前也为 Meta 广告搜索、Meta 公司广告和 Reddit 帖子评论定义了 POST 变体,仅在官方操作要求时使用 POST。示例操作:provider 为 scrapecreators、method 为 GET、path 为 /v1/instagram/profile、query 含 handle: brand。端点名称可能变化,若请求失败或参数不明确,应先读取官方 OpenAPI 再猜测。
采集规则与输出契约 采集规则包括:确认平台、市场、时间窗口与样本量;先用小请求并检查响应结构;沿返回的 cursor 继续,直到达到所需样本或不再有 cursor;为每条数据保留原始来源 URL、创作者 handle、平台、发布日期与互动字段;按平台原生内容 ID 或规范 URL 去重;将 API 返回的事实与分析中推断的结论分开;不得以粉丝数作为受众契合度或帖子质量的替代指标。 输出契约要求提供方调用返回标准化的来源集合,字段示例包括 platform、query、collected_at(ISO-8601)、items(含 id、url、author、published_at、text、metrics)、next_cursor(可为 null)、limitations(数组)。
适用场景 适用于需要通过统一接口获取多平台公开社交数据与广告库数据的研究、分析类工作流,尤其是对结构化数据规模和一致性有要求的场景。
限制 资料未提供具体的收费、价格、平台覆盖完整清单与调用配额等信息,相关事实暂未提供。使用应以 ScrapeCreators 官方 OpenAPI(https://docs.scrapecreators.com/openapi.json)为端点与参数的权威来源;资料明确不应用 Orthogonal 搜索或详情来发现 ScrapeCreators 操作,因为其镜像目录可能不完整。