# 有没有获取抖音热搜榜的 API？

> 以 JSON 获取抖音热榜：排名、热词和热度值，多久拉一次合适、要花多少钱，以及怎么找到每个热点背后的视频。

网页版：https://okdata.online/zh/answers/douyin-hot-search-api/

**简短回答：**有。okdata 的抖音热搜榜接口一次调用返回当前榜单，约 50 条，每条有排名、热词和热度值，$0.002 一次。每小时拉一次，一天 $0.048；想看某个热点下的视频，再调一次视频搜索，每页 $0.02。

一家媒体希望，只要有和自己报道领域相关的话题冲进抖音热榜前十，就自动往群里发一条消息。一个品牌团队想每天早上收到一份榜单摘要，把和品类相关的条目标出来。两者都需要定时拿到结构化的榜单数据，而直接爬 App 的热榜页面，意味着要搞定签名、设备参数和浏览器。一次 API 调用就能拿到整张榜单的 JSON。

## 接口

[抖音热搜榜](/zh/apis/douyin/trends/list/)不需要任何参数。调用一次返回当前的主热搜榜，约 50 条，每条有：

- `rank`：榜单位置；
- `name`：抖音展示的热词；
- `heat`：抖音的热度值；
- `url`：这个词在 douyin.com 上的搜索链接。

## 定时拉取的费用

| 频率 | 每天调用 | 每天 | 30 天 |
|---|---|---|---|
| 每小时一次 | 24 | $0.048 | $1.44 |
| 每 15 分钟一次 | 96 | $0.192 | $5.76 |
| 每小时一次，另外每天给 3 个新热点各搜 1 页 | 27 | $0.108 | — |

## 示例

```bash
curl -s "https://api.okdata.online/v1/douyin/trends/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  | jq -r '.data.items[:10][] | "\(.rank). \(.name)  \(.heat)"'
```

想看某个热词下的视频，把 `name` 传给[视频搜索](/zh/apis/douyin/videos/search/)，用 `sort=most_liked`。

## 需要知道的

- 这是主热搜榜。抖音的其他榜单（娱乐榜、社会榜、挑战榜、音乐榜）不在目录里。
- 第一条可能是抖音置顶的话题，没有热度值，`heat` 为 null。排名按榜单顺序给出。
- 返回里没有历史数据。想要历史，就每次连同 `meta.fetched_at` 存一份快照。
- 频率限制按 key 计算，响应头 `X-RateLimit-Remaining` 会告诉轮询程序还剩多少余量，什么时候该等一等。

## 其他选择

个人看看的话，抖音 App 里的热榜免费。热榜聚合网站把几个平台的榜单放在一起，适合随手看看。创作者工具里的抖音热点宝面向创作者提供更多分析。要接进自己的系统做预警和存档，用 API 更简单。如果同时关注微博，也能取[微博热搜](/zh/apis/weibo/trends/list/)；两边一起做的方案见[趋势研究方案](/zh/solutions/trend-research/)。

## 用到的接口

- [抖音热搜榜](https://okdata.online/zh/apis/douyin/trends/list/) `douyin.trends.list`：$0.002/次 · 每页约 50 条榜单
- [抖音视频搜索](https://okdata.online/zh/apis/douyin/videos/search/) `douyin.videos.search`：$0.02/次 · 每页约 20 条视频

更新于 2026-11-12
