社媒数据（beta）

/

GET /v1/social/{platform}/{capability} 返回抖音、小红书、TikTok、YouTube 等社交平台的公开数据，与模型调用共用同一个 API 密钥和余额。每个平台的每项能力按成功调用次数计价；data 是平台自己的原始响应——各平台的字段并未统一。

GET /v1/social/{platform}/{capability} 
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
Beta：仅限已付费账户 调用前请先完成首次充值。试用额度不能用于这些端点；从未充值的账户会收到 HTTP 403 model_requires_topup。Beta 不提供 SLA，平台、端点和价格都可能调整。

认证与计费

与任何模型调用一样，把 ChinaAPI 密钥作为 Bearer 令牌发送到 https://api.chinaapi.ai。只有返回 HTTP 200 且带数据时才计费，按该端点标示的价格扣一次；结果为空、参数被拒或上游失败都不收费。每取一页都是一次独立调用。使用日志里，每次调用都记在端点旁标示的名称下，例如 social-douyin-search。

响应与错误

成功的响应会用一层简单的外壳包住平台数据。data 里的一切——字段名、翻页游标、ID——都是平台自己的；游标请原样传回。

{
  "object": "social.result",
  "platform": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 400 — 参数未知、重复、过长、类型不对或缺失，包括「至少填一项」的参数组一个都没给。错误的 code 会说明是哪一种，例如 unknown_parameter 或 missing_parameter。
  • 403 model_requires_topup — 该账户尚未完成首次充值。
  • 404 — 不存在这个平台与能力的组合，或平台按这些参数什么也没找到（social_data_no_result）。
  • 429 social_data_capacity_reached — Beta 当天的容量已用完，于 00:00 UTC 重置；或平台繁忙，几秒后重试即可。不要无间隔地循环重试。
  • 502 — 数据源没有应答，或应答了但没有数据。
  • 503 social_data_unavailable — 该端点当前已暂停；实时目录中它的状态为 paused。

以上响应都不计费。

使用规范

请遵守各平台的条款以及适用于你的数据保护规定。不得用本 API 建立个人画像。登录、提取联系方式、操纵互动数据、获取私密或付费内容均不在本 Beta 范围内。

平台与价格

单位为每次成功调用的美元价格。每个价格都链接到下方对应的端点，短横表示该平台不提供这项能力。当前在售哪些端点（包括已暂停的）以实时目录为准——GET https://dash.chinaapi.ai/api/social/catalog，无需密钥。

端点

参数放在查询字符串里，使用平台自己的参数名。示例取自目录；请把其中的标识符换成你要获取的内容。