批量链接数据（batch_stats）

POST /v1/tools/batch_stats 运行批量链接数据：一个现成工具，返回一批帖子或主页链接现在的数字，以及哪些已经失效；最多 2,000 条，没有 AI 分析。目前可读 17 个平台，每条链接 1 积分起。带上 max_cost_credits，超出时会被免费拒绝，并返回报价。失效的链接不扣。

想在网站上填写，或看看结果长什么样，打开批量链接数据。

请求

请求体是 JSON，放这个工具自己的输入。Key 和其他调用一样，放在 Authorization 请求头里。

curl https://api.socialtoai.com/v1/tools/batch_stats \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "urls": ["https://x.com/NASA"]  }'

import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/tools/batch_stats",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "urls": ["https://x.com/NASA"],    },)print(response.json())

每条链接的积分

每条链接算一行，按它所在平台的一次调用计。

结果里有什么

先报价还是直接运行：confirm

同一个请求，要么直接运行，要么先返回报价。和工具输入放在一起的布尔参数 confirm 决定走哪一种：

运行的返回里带一个 handle：24 小时内可以凭它免费重读完整结果，细节见结果与句柄。带着同一个 Idempotency-Key 再发同样的请求，返回的是第一次运行的结果，不再扣费。

报价

报价是这一次请求的完整计划，以及运行它最多扣多少。报价本身不占用、不取数、不扣积分，status 是 quote。

运行怎么扣费

• 按行计价：每条链接是一行，按它所在平台一次调用的积分算。
• 失效的行不扣：已删除、认不出或被跳过的行不扣积分；有数字的行照扣，数字为零也一样。
• 先看到上限：运行前先给出这批链接最多要多少积分，实际不会超过它。
• 已删除、认不出或被跳过的行不扣积分；有数字返回的行照扣，数字为零也一样。中途取消后，已完成的行照扣，没跑的行不扣。
• 那个平台上失败的行不扣积分，其他行不受影响。一批里失败的行超过三成时，不再继续跑后面的。

通过 MCP

MCP 工具是 research，调用时把 tool 设为 batch_stats。输入和积分都一样。工具列表 里有你的 AI 拿到的描述。

最近更新：2026-10-17