按数据类型找接口
社区帖子接口
2 个平台的 2 个接口，用同一个 Post 对象返回社区帖子。某个社区、小组或版块里的帖子，可按热门、最新或最高分排，每条带标题、正文、作者、得分和评论数。每次 $0.0003 到 $0.004，各接口按自己的价格计费；失败的调用不扣费。
社区帖子 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| Reddit 社区帖子 | GET /v1/reddit/subreddits/posts/list | 25 | $0.004/次 · 每页约 25 条帖子 | |
| X（推特） | X 社群帖子 | GET /v1/x/communities/posts/list | 20 | $0.0003/条 · 每次最多 $0.006 |
每次 $0.0003 到 $0.004，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: 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 -G "https://api.okdata.online/v1/reddit/subreddits/posts/list" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=nasa'
# X（推特）
curl -G "https://api.okdata.online/v1/x/communities/posts/list" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=1539231166569410560'常见用途
- 看产品自己的社区这周在抱怨什么。
- 把某个垂直社区的高分帖子收集起来当调研素材。
- 盯着某个社区，看有没有帖子提到你的品牌。
常见问题
- 用哪种排序？
- 想看成员正在聊什么用热门，做监测用最新，找一段时间里最好的帖子用最高分。最高分排序如果能选时间范围，接口页会写明可选哪些。
- 和搜索有什么不同？
- 搜索是在全平台找你给的词。社区列表只看一个社区，不管帖子里有没有你的关键词，都会返回。
- 哪些平台有？
- 以社区为单位组织内容的平台，比如分了版块的论坛。接口按平台逐个上线，现在能调用的都列在上面的表里。