按数据类型找接口
热门内容接口
4 个平台的 4 个接口，用同一个 Post 对象返回热门内容。平台此刻排在热门或趋势榜上的内容，从最热开始，每条带文案、作者和互动数据。每次 $0.002 到 $0.04，各接口按自己的价格计费；失败的调用不扣费。
热门内容 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| Reddit 热门帖子 | GET /v1/reddit/popular/posts/list | 10 | $0.002/次 · 每页约 10 条帖子 | |
| 抖音 | 抖音视频榜 | GET /v1/douyin/videos/trending | 9 | $0.002/次 · 每页约 9 条视频 |
| 小红书 | 小红书蒲公英内容广场热门笔记 | GET /v1/xiaohongshu/pgy/notes/trending | 34 | $0.04/次 · 每页约 34 篇笔记 |
| B站 | B站综合热门 | GET /v1/bilibili/videos/trending | 20 | $0.002/次 · 每页约 20 条视频 |
每次 $0.002 到 $0.04，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: Post
上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。
| 字段 | 类型 | 含义 |
|---|---|---|
id | string | 内容在平台上的 ID。 |
url | string | 内容链接。 |
type | string | 内容类型。 |
title | string | null | 标题（视频、笔记、文章才有）。 |
text | string | 文案、正文或简介，纯文本；文章为 Markdown。 |
lang | string | null | 语言代码，平台给出或检测得到。 |
published_at | string | null | 发布时间，ISO 8601，UTC；只有数据源不给时间时为 null（wechat_mp.articles.metrics、wechat_channels.videos.metrics、youtube.channels.videos.list 取 Shorts 时），并列在 meta.unavailable 里。 |
author | AccountRef | 发布者。 |
metrics | Metrics | 抓取时的数据；平台不公开的为 null。 |
images | string[] | null | 图文内容的图片地址。 |
hashtags | string[] | null | 话题标签，不带 #。 |
ext | object | 平台特有字段，只在 view=full 时返回。 |
两个平台上的同一个调用
参数一样、翻页方式一样、返回结构一样，只换路径。
# Reddit
curl "https://api.okdata.online/v1/reddit/popular/posts/list" \
-H "Authorization: Bearer $OKDATA_API_KEY"
# 抖音
curl "https://api.okdata.online/v1/douyin/videos/trending" \
-H "Authorization: Bearer $OKDATA_API_KEY"常见用途
- 看今天哪些内容正在起量，而不只是哪些话题。
- 每小时存一次热门流，研究什么样的内容能上去。
- 让 AI 先读今天的热门内容，再出选题。
常见问题
- 和热榜有什么区别？
- 热榜列的是话题或搜索词和排名。这个接口返回的是内容本身，带文案和互动数据，你看到的是真正在火的内容，不用从一个关键词去猜。
- 能看昨天的热门吗？
- 不能。每次调用返回的都是榜单当下的样子，即使这个榜本身统计的是最近几天。想留历史，就定时调用，把每次结果连同读取时间存下来。
- 哪些平台有？
- 只有公开了热门流的平台才可能有，接口按平台逐个上线。现在能调用的都列在上面的表里。