最快怎么用?
先在登录工作台用示例输入跑通结果,再复制请求接入。字段表和状态码在下方,真正开发时再看就行。
你只需要准备
period
dayrankDate
2026-08-19category
全部三步完成
- 1. 打开直接调用工作台,示例 JSON 已经帮你填好。
- 2. 使用登录会话完成校验和调用,先确认返回结果是不是你要的。
- 3. 复制 cURL 或 JavaScript 示例,放到你的产品/脚本里。
按行业分类查询抖音涨粉账号排行,返回账号、粉丝增量和排名。日榜/周榜/月榜都可用,但**榜单日期必须落在周期边界**:周榜填那一周的周一、月榜填那个月的 1 号,且周期要已经结束(本周一/本月 1 号还没数据)。日榜最新滞后约两天,填今天或昨天会是空榜。分类是闭集(官方 27 个赛道 +「全部」),写表外的名字上游会报「无效的分类参数」。
先在登录工作台用示例输入跑通结果,再复制请求接入。字段表和状态码在下方,真正开发时再看就行。
day2026-08-19全部工作台直接调用使用登录会话,不需要粘贴密钥;API Key 留给自己的产品、脚本或 Agent 接入。
Authorization: Bearer <你的 key> 请求头即可。POSThttps://doubaoya.com/api/apis/douyin/douyin-rise-fans-rank/call| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 用于识别你的账号,每次请求必填,格式 Bearer + 空格 + 密钥 | Bearer dyh_xxxxxx |
| Content-Type | string | 是 | 请求体数据类型 | application/json |
当前目录提供请求示例,未声明 required 元数据;下列字段仅表示示例结构,实际约束以接口校验结果为准。
| 字段 | 类型 | 字段性质 | 说明 | 示例 |
|---|---|---|---|---|
| period | String | 示例字段 | period | day |
| rankDate | String | 示例字段 | rankDate | 2026-08-19 |
| category | String | 示例字段 | category | 全部 |
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| success | Boolean | 是否成功 | true |
| requestId | String | 请求追踪 ID | req_xxx |
| rank | Integer | rank | 1 |
| accountName | String | accountName | 样例账号 |
| riseFans | Integer | riseFans | 120000 |
| 状态码 | 说明 | 排查建议 |
|---|---|---|
| 400 | 输入内容有误 | 检查示例 JSON 中的字段、链接或关键词是否填写正确。 |
| 401 | 鉴权失败 | 确认请求头已添加 API Key,且密钥有效、未禁用。 |
| 402 | 积分不足 | 账户余额不足以支付本次调用,请前往控制台充值。 |
| 502 | 数据源暂时不可用 | 稍后重试;持续出现请联系技术支持。 |