POST
/v1/call/douyin.account_metrics预览抖音巨量算数达人核心指标接口
抖音独有的接口。
抖音巨量算数达人核心指标 API(数据接口)按抖音账号的数字编号取巨量算数给的达人核心指标:最近一周和最近一个月平均每天新增的点赞、粉丝、分享、评论数,以及各自和上一个周期相比的变化比例。平台没有数据的账号(各项全是 0)返回“不存在”。每次调用 2 积分(约 $0.004–$0.0067),失败不扣。用 HTTP 调用,或让 AI 客户端通过 MCP 调用。最近实测:2026-10-17。
2 积分每次调用
一个对象每次调用返回
2026-10-17最近实测
1.1 KB示例返回的体积(1 条)
最近更新:
预览:这个接口还没有标为稳定,参数和返回字段之后可能调整。计费和其他调用一样,调用失败不扣积分。
请求与返回
curl https://api.socialtoai.com/v1/call/douyin.account_metrics \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "66598046050" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/call/douyin.account_metrics", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "id": "66598046050", },)print(response.json())# 已经通过 MCP 接好了?直接用大白话问。用“抖音巨量算数达人核心指标”接口(douyin.account_metrics),参数是 id: 66598046050。# 你的 AI 会调用 call 工具,参数是:{ "id": "66598046050"}200 OK1.1 KB2 积分
{ "op": "douyin.account_metrics", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "…", "ref": "…", "approx": [], "type": "entry", "entry_type": "index_creator_metrics", "title": null, "url": null, "rank": null, "heat": null, "fields": { "average_7d": { "likes": 157100.7142857143, "followers": 3588, "shares": 14715.42857142857, "comments": 3879.8571428571427 }, "average_30d": { "likes": 300077.7, "followers": 6233.6, "shares": 17969.833333333332, "comments": 7351.466666666666 }, "change_7d": { "likes": -0.20028666505711482, "followers": -0.1607298001737619, "shares": 0.8577740905729795, "comments": -0.28813692598028945 }, "change_30d": { "likes": -0.12000717497205526, "followers": -0.1316211058123174, "shares": -0.1697698557902584, "comments": -0.23841359186421957 } } } ], "unavailable": [], "cost_credits": 2}- entry_type
- index_creator_metrics
示例里的名称和正文已去掉,数字是录制时的真实值。
示例数据完整返回
1 个参数。
全部必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 必填 | — | 抖音账号的数字编号(uid),一串数字;不是账号资料接口用的那种以 MS4w 开头的编号 |
这些值从哪里拿。
id抖音账号的数字编号(uid),一串数字;不是账号资料接口用的那种以 MS4w 开头的编号(例如 66598046050)
平台上没有别的接口返回它,按上面的说明从网页或链接里取。
items 里每一条的字段。
抖音给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接;平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次,从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.average_7d.likes | number | 最近一周平均每天新增的点赞数。 |
| items[].fields.average_7d.followers | number | 最近一周平均每天新增的粉丝数。 |
| items[].fields.average_7d.shares | number | 最近一周平均每天新增的分享数。 |
| items[].fields.average_7d.comments | number | 最近一周平均每天新增的评论数。 |
| items[].fields.average_30d.likes | number | 最近一个月平均每天新增的点赞数。 |
| items[].fields.average_30d.followers | number | 最近一个月平均每天新增的粉丝数。 |
| items[].fields.average_30d.shares | number | 最近一个月平均每天新增的分享数。 |
| items[].fields.average_30d.comments | number | 最近一个月平均每天新增的评论数。 |
| items[].fields.change_7d.likes | number | 最近一周日均新增点赞数相比上一周的变化比例。 |
| items[].fields.change_7d.followers | number | 最近一周日均新增粉丝数相比上一周的变化比例。 |
| items[].fields.change_7d.shares | number | 最近一周日均新增分享数相比上一周的变化比例。 |
| items[].fields.change_7d.comments | number | 最近一周日均新增评论数相比上一周的变化比例。 |
| items[].fields.change_30d.likes | number | 最近一个月日均新增点赞数相比上一个月的变化比例。 |
| items[].fields.change_30d.followers | number | 最近一个月日均新增粉丝数相比上一个月的变化比例。 |
| items[].fields.change_30d.shares | number | 最近一个月日均新增分享数相比上一个月的变化比例。 |
| items[].fields.change_30d.comments | number | 最近一个月日均新增评论数相比上一个月的变化比例。 |
null抖音给不了的字段这个调用的字段抖音都给得出;单条内容缺某个值时,那个字段是 null。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
会发生什么。
一次调用返回一个对象,不翻页,2 积分。
每把 Key 每秒 1 次,购买后 5 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
接好 MCP 后,这样问就会用到它。
按抖音账号的数字编号取巨量算数给的达人核心指标:66598046050
2 积分call {"op":"douyin.account_metrics","id":"66598046050"}
常见问题。
简短回答。
抖音的全部接口需要抖音账号,或者申请抖音官方的 API 吗?
不需要,只要一把 SocialToAI 的 Key。返回的是抖音上公开可见的内容和账号信息,你不用登录抖音,也不用在那边申请任何东西。
“预览”是什么意思?
预览:这个接口还没有标为稳定,参数和返回字段之后可能调整。计费和其他调用一样,调用失败不扣积分。