按数据类型找接口
账号作品列表接口
12 个平台的 12 个接口，用同一个 Post 对象返回账号作品。某个账号发布过的内容，大多数平台按从新到旧排，按页返回：每条的文案、链接、发布时间和互动数据。每次 $0.002 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。
账号作品列表 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | 抖音账号作品列表 | GET /v1/douyin/users/videos/list | 20 | $0.002/次 · 每页约 20 条视频 |
| 小红书 | 小红书博主笔记列表 | GET /v1/xiaohongshu/users/notes/list | 20 | $0.02/次 · 每页约 20 篇笔记 |
| 微信公众号 | 公众号历史文章 | GET /v1/wechat_mp/accounts/articles/list | 10 | $0.02/次 · 每页约 10 篇文章 |
| X（推特） | X 账号帖子列表 | GET /v1/x/users/posts/list | 20 | $0.002/次 · 每页约 20 条帖子 |
| Instagram 账号帖子 | GET /v1/instagram/users/posts/list | 12 | $0.004/次 · 每页约 12 条帖子 | |
| Reddit 用户帖子 | GET /v1/reddit/users/posts/list | 25 | $0.002/次 · 每页约 25 条帖子 | |
| 快手 | 快手账号作品 | GET /v1/kuaishou/users/videos/list | 20 | $0.02/次 · 每页约 20 条视频 |
| 知乎 | 知乎用户文章 即将上线 | GET /v1/zhihu/users/articles/list | 20 | $0.002/次 · 每页约 20 篇文章 |
| 微信视频号 | 视频号账号作品 | GET /v1/wechat_channels/users/videos/list | 15 | $0.02/次 · 每页约 15 条视频 |
| 微博 | 微博用户微博 | GET /v1/weibo/users/posts/list | 20 | $0.002/次 · 每页约 20 条帖子 |
| B站 | B站用户投稿 | GET /v1/bilibili/users/videos/list | 30 | $0.002/次 · 每页约 30 条视频 |
| TikTok | TikTok 账号作品 | GET /v1/tiktok/users/videos/list | 10 | $0.002/次 · 每页约 10 条视频 |
每次 $0.002 到 $0.02，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: 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 时返回。 |
两个平台上的同一个调用
参数一样、翻页方式一样、返回结构一样，只换路径。
# 抖音
curl -G "https://api.okdata.online/v1/douyin/users/videos/list" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=MS4wLjABAAAA...'
# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/users/notes/list" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=5f1234567890abcdef123456'常见用途
- 拉出竞品最近三个月的作品，看哪种形式点赞最多。
- 投放前确认达人最近还在稳定更新。
- 把一个公众号的历史文章存进知识库。
常见问题
- 最多能往前翻多远？
- 用 page.next_cursor 一页页往前翻，直到 page.has_more 为 false。能翻到多早由平台决定；每页一次调用，所以补历史的费用就是页数乘以表里的价格。
- 每条内容带互动数据吗？
- 带。每条内容都有 metrics，包括抓取时平台展示的播放、点赞、评论、分享和收藏数；平台不公开的为 null。
- 能只拿上次之后的新内容吗？
- 读第一页，遇到已经存过的内容 id 就停。在按从新到旧排的平台上，每天检查一次通常每个账号只要一次调用。