# 热榜接口

> 7 个平台的 7 个接口，用同一个 Trend 对象返回热榜。调用那一刻平台自己的热榜：每一条的排名、话题或搜索词、平台显示的热度值和链接。每次 $0.002 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。

网页版：https://okdata.online/zh/roles/trends-list/

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | [抖音热搜榜](https://okdata.online/zh/apis/douyin/trends/list/) | `GET /v1/douyin/trends/list` | 50 | $0.002/次 · 每页约 50 条榜单 |
| 小红书 | [小红书热点话题](https://okdata.online/zh/apis/xiaohongshu/trends/list/) | `GET /v1/xiaohongshu/trends/list` | 20 | $0.02/次 · 每页约 20 条榜单 |
| B站 | [B站热搜榜](https://okdata.online/zh/apis/bilibili/trends/list/) | `GET /v1/bilibili/trends/list` | 50 | $0.002/次 · 每页约 50 条榜单 |
| 微博 | [微博热搜](https://okdata.online/zh/apis/weibo/trends/list/) | `GET /v1/weibo/trends/list` | 50 | $0.002/次 · 每页约 50 条榜单 |
| X（推特） | [X 趋势](https://okdata.online/zh/apis/x/trends/list/) | `GET /v1/x/trends/list` | 30 | $0.009/次 · 每页约 30 条榜单 |
| Reddit | [Reddit 趋势搜索](https://okdata.online/zh/apis/reddit/trends/list/) | `GET /v1/reddit/trends/list` | 6 | $0.002/次 · 每页约 6 条榜单 |
| 快手 | [快手热榜](https://okdata.online/zh/apis/kuaishou/trends/list/) | `GET /v1/kuaishou/trends/list` | 51 | $0.002/次 · 每页约 51 条榜单 |

## 返回的对象：[Trend](https://okdata.online/zh/docs/objects/trend/)

上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。

| 字段 | 类型 | 含义 |
|---|---|---|
| `rank` | `integer` | 榜单排名，1 为第一。 |
| `name` | `string` | 话题或搜索词。 |
| `heat` | `number \| null` | 平台给出的热度值，各平台口径不同。 |
| `url` | `string \| null` | 话题页链接（有的话）。 |

## 两个平台上的同一个调用

参数一样、翻页方式一样、返回结构一样，只换路径。

```bash
# 抖音
curl "https://api.okdata.online/v1/douyin/trends/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY"

# 小红书
curl "https://api.okdata.online/v1/xiaohongshu/trends/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY"
```

## 常见用途

- 每小时存一次榜，看一个话题在榜上能待多久。
- 品牌或产品名一上榜就提醒团队。
- 让 AI 先读今天的热榜，再出选题。

## 常见问题

### 不同平台的热度值能直接比吗？

不能。每个平台的热度算法和量级都不一样，有的平台根本不显示热度。跨平台比较时看排名和在榜时长更靠谱。

### 能查昨天的榜吗？

接口返回的是当下的榜单。想要历史，就定时调用并自己存下来；本站的免费热榜页面也为部分榜单保留了每日存档。

### 多久读一次榜合适？

热榜一小时内就会变，每小时读一次比较常见。每读一次是一次调用，一天 24 次就是表里价格的 24 倍。

## 其他数据类型

- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [热门内容接口](https://okdata.online/zh/roles/posts-trending/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)
- [内容数据接口](https://okdata.online/zh/roles/posts-metrics/)
- [社区帖子接口](https://okdata.online/zh/roles/communities-posts-list/)
- [广告详情接口](https://okdata.online/zh/roles/ads-get/)
- [广告主广告列表接口](https://okdata.online/zh/roles/advertisers-ads-list/)
- [广告搜索接口](https://okdata.online/zh/roles/ads-search/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)
- [粉丝列表接口](https://okdata.online/zh/roles/accounts-followers-list/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品评价接口](https://okdata.online/zh/roles/products-reviews-list/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)
- [达人搜索接口](https://okdata.online/zh/roles/creators-search/)
- [达人详情接口](https://okdata.online/zh/roles/creators-get/)
- [达人粉丝画像接口](https://okdata.online/zh/roles/creators-audience-get/)