POST
/v1/call/douyin.brand_history预览抖音巨量算数品牌指数趋势接口
抖音独有的接口。
抖音巨量算数品牌指数趋势 API(数据接口)按品牌名和起止日期,取这个品牌在抖音上逐日的搜索指数、内容指数和传播指数(巨量算数)。指数是平台算出的分,不是次数;日期是中国时间(UTC+8)的自然日。每次调用 2 积分(约 $0.004–$0.0067),失败不扣。用 HTTP 调用,或让 AI 客户端通过 MCP 调用。最近实测:2026-10-17。
2 积分每次调用
一个对象每次调用返回
2026-10-17最近实测
1.4 KB示例返回的体积(1 条)
最近更新:
预览:这个接口还没有标为稳定,参数和返回字段之后可能调整。计费和其他调用一样,调用失败不扣积分。
请求与返回
curl https://api.socialtoai.com/v1/call/douyin.brand_history \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "brand": "泡泡玛特", "since": "2026-09-01T00:00:00Z", "until": "2026-09-30T00:00:00Z" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/call/douyin.brand_history", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "brand": "泡泡玛特", "since": "2026-09-01T00:00:00Z", "until": "2026-09-30T00:00:00Z", },)print(response.json())# 已经通过 MCP 接好了?直接用大白话问。用“抖音巨量算数品牌指数趋势”接口(douyin.brand_history),参数是 brand: 泡泡玛特,since: 2026-09-01T00:00:00Z,until: 2026-09-30T00:00:00Z。# 你的 AI 会调用 call 工具,参数是:{ "brand": "泡泡玛特", "since": "2026-09-01T00:00:00Z", "until": "2026-09-30T00:00:00Z"}200 OK1.4 KB2 积分
{ "op": "douyin.brand_history", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "泡泡玛特", "ref": "泡泡玛特", "approx": [], "type": "entry", "entry_type": "brand_history", "title": "泡泡玛特", "url": null, "rank": null, "heat": null, "fields": { "category": "母婴", "points": [ { "date": "2026-09-01T00:00:00Z", "search_index": 121864, "content_index": 41224, "spread_index": 75601 }, { "date": "2026-09-02T00:00:00Z", "search_index": 122413, "content_index": 46057, "spread_index": 77637 }, { "date": "2026-09-03T00:00:00Z", "search_index": 122213, "content_index": 45504, "spread_index": 77642 }, { "date": "2026-09-04T00:00:00Z", "search_index": 122205, "content_index": 54042, "spread_index": 78337 }, { "date": "2026-09-05T00:00:00Z", "search_index": 124682, "content_index": 42229, "spread_index": 77377 }, { "date": "2026-09-06T00:00:00Z", "search_index": 124155, "content_index": 42738, "spread_index": 76569 }, { "date": "2026-09-07T00:00:00Z", "search_index": 121751, "content_index": 41525, "spread_index": 76108 } ] } } ], "unavailable": [], "cost_credits": 2}- entry_type
- brand_history
- category
- 母婴
示例里的名称和正文已去掉,数字是录制时的真实值。
示例数据完整返回
3 个参数。
全部必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| brand | string | 必填 | — | 品牌名,要和巨量算数收录的写法一致 |
| since | datetime | 必填 | — | 从哪一天起(含):取这个时刻所在的中国时间(UTC+8)自然日 |
| until | datetime | 必填 | — | 到哪一天止(含),取法同上。平台的数通常晚一到两天出:还没出数的日子,指数为 null |
items 里每一条的字段。
抖音给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接;平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次,从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.category | string | 平台给这个品牌归的行业,用平台的原话。 |
| items[].fields.points | array | 逐日指数,每天一项,按日期从早到晚:date、search_index、content_index、spread_index。 |
null抖音给不了的字段这个调用的字段抖音都给得出;单条内容缺某个值时,那个字段是 null。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
会发生什么。
一次调用返回一个对象,不翻页,2 积分。
每把 Key 每秒 1 次,购买后 5 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
接好 MCP 后,这样问就会用到它。
按品牌名和起止日期,取这个品牌在抖音上逐日的搜索指数、内容指数和传播指数(巨量算数)(brand:泡泡玛特,since:2026-09-01T00:00:00Z,until:2026-09-30T00:00:00Z)
2 积分call {"op":"douyin.brand_history","brand":"泡泡玛特","since":"2026-09-01T00:00:00Z","until":"2026-09-30T00:00:00Z"}
常见问题。
简短回答。
抖音的全部接口需要抖音账号,或者申请抖音官方的 API 吗?
不需要,只要一把 SocialToAI 的 Key。返回的是抖音上公开可见的内容和账号信息,你不用登录抖音,也不用在那边申请任何东西。
“预览”是什么意思?
预览:这个接口还没有标为稳定,参数和返回字段之后可能调整。计费和其他调用一样,调用失败不扣积分。