按数据类型找接口
热榜接口
7 个平台的 7 个接口，用同一个 Trend 对象返回热榜。调用那一刻平台自己的热榜：每一条的排名、话题或搜索词、平台显示的热度值和链接。每次 $0.002 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。
热榜 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | 抖音热搜榜 | GET /v1/douyin/trends/list | 50 | $0.002/次 · 每页约 50 条榜单 |
| 小红书 | 小红书热点话题 | GET /v1/xiaohongshu/trends/list | 20 | $0.02/次 · 每页约 20 条榜单 |
| B站 | B站热搜榜 | GET /v1/bilibili/trends/list | 50 | $0.002/次 · 每页约 50 条榜单 |
| 微博 | 微博热搜 | GET /v1/weibo/trends/list | 50 | $0.002/次 · 每页约 50 条榜单 |
| X（推特） | X 趋势 | GET /v1/x/trends/list | 30 | $0.009/次 · 每页约 30 条榜单 |
| Reddit 趋势搜索 | GET /v1/reddit/trends/list | 6 | $0.002/次 · 每页约 6 条榜单 | |
| 快手 | 快手热榜 | GET /v1/kuaishou/trends/list | 51 | $0.002/次 · 每页约 51 条榜单 |
每次 $0.002 到 $0.02，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: Trend
上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。
| 字段 | 类型 | 含义 |
|---|---|---|
rank | integer | 榜单排名，1 为第一。 |
name | string | 话题或搜索词。 |
heat | number | null | 平台给出的热度值，各平台口径不同。 |
url | string | null | 话题页链接（有的话）。 |
两个平台上的同一个调用
参数一样、翻页方式一样、返回结构一样，只换路径。
# 抖音
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 倍。