覆盖全球 10 大社交、社区与口碑平台,一键提取帖子、评论、主页资料、作品列表、关键词搜索、字幕及互动统计。不同平台开放的接口见下方卡片和侧栏。
支持的社媒平台
卡片展示每个平台最多 5 个核心接口。全部 47 个公开接口保留在侧栏;Naver Cafe 使用独立的帖子搜索接口。
请求URL
key 为接口名称,例如 reddit-comments。上表中的接口页面提供对应 URL、参数和在线调试入口。
请求头
| 参数名 | 参数值 | 类型 | 说明 |
|---|
| Content-Type | application/json | string | 数据格式 |
| Authorization | Bearer xxx | string | 认证凭证 |
前9个平台采集最长约75秒,客户端建议等待90秒;Naver Cafe 采集超时230秒,客户端建议至少245秒。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|
| target | Yes | string | 目标链接、ID 或搜索关键词;具体格式见对应接口。 |
| options | No | object | 仅使用接口列出的页数、排序、筛选及游标参数;未开放字段忽略。 |
target去除首尾空白后须为1–2048个字符。搜索、评论接口默认1页,最多5页;超过上限按上限处理,页数必须为正整数。未列出的options忽略。
响应值
| 返回值 | 类型 | 说明 |
|---|
| code | integer | 状态码,0 表示成功 |
| message | string | 响应信息,成功时为 ok |
| pointCost | number | 本次请求实际消耗的积点 |
| data | object | 采集结果;字段随平台和接口变化 |
| meta | object | 请求标识 requestId、耗时 durationMs |
| billing | object | 单价 unitPrice、条数 billedCount、费用 pointCost、规则版本 ruleVersion、计量明细 counts |
将返回游标传入对应的 options 字段。Pinterest 评论使用 pagination.comments.bookmark,Reddit 列表使用 pagination.after;具体对应关系见各接口参数表。分页可能返回重复记录,可按 ID 去重。hasMore=true 且游标为空时,不应直接循环续取。
成功返回 code=0。余额不足返回 code=2001;采集失败返回 code=9400,详情见 error.code 和 error.message。失败请求的 pointCost=0。遇到限流可根据 Retry-After 等待后重试,排查时提供响应头 X-Request-Id。
请求示例
返回示例
各接口返回不同的数据结构,请查看 Reddit Comments API 等接口页面中的实际响应示例。
计费规则
统一计费标准:0.8 积点 / 一条有效返回结果。
计费示例
- 调用
COMMENTS 接口:按实际返回的每条一级评论计费,随一级评论返回的回复免费(Facebook 规则见下方说明)。例如:返回 4 条一级评论及 4 条附带回复,计为 4 条有效结果,消耗 3.2 积点。单独查询回复时,按实际返回的回复条数计费。
- Facebook 评论/回复:一级评论与单独获取的回复均按条计费,每条 0.8 积点。例如:返回 4 条一级评论及 4 条回复,计为 8 条有效结果,消耗 6.4 积点。
- 调用
POST 接口:按帖子主体计费,随详情返回的首屏评论等附带数据免费。例如:返回 1 条帖子详情及附带的首屏评论,计为 1 条有效结果,消耗 0.8 积点。
- 调用
WORKS / SEARCH 接口:按实际返回的作品或搜索结果条数计费,结果中附带的作者等信息免费。
去重与免扣费保障
- 空结果与失败不扣费:采集结果为空或请求失败时,
pointCost = 0,不扣除积点。
- 单次响应自动去重:同一响应内相同 ID 的记录只计费一次;不同次独立调用或分页续取,分别按实际返回的有效结果计费。具体费用以响应中的
pointCost 及 billing 字段为准。评论正文为空不等于结果为空,已返回的有效评论记录仍计费。
通过 AI Agent 调用,请参阅 MCP。