按数据类型找接口
内容详情接口
13 个平台的 16 个接口,用同一个 Post 对象返回内容详情。按 ID 或链接取一条内容(视频、笔记、帖子或文章):全文、作者、发布时间、图片,以及调用那一刻的互动数据。每次 $0.0003 到 $0.02,各接口按自己的价格计费;失败的调用不扣费。
内容详情 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | 抖音视频详情 | GET /v1/douyin/videos/get | 1 | $0.002/次 |
| 小红书 | 小红书笔记详情 | GET /v1/xiaohongshu/notes/get | 1 | $0.02/次 |
| 微信公众号 | 公众号文章详情 | GET /v1/wechat_mp/articles/get | 1 | $0.02/次 |
| B站 | B站视频详情 | GET /v1/bilibili/videos/get | 1 | $0.002/次 |
| TikTok | TikTok 视频详情 | GET /v1/tiktok/videos/get | 1 | $0.002/次 |
| X(推特) | X 帖子详情 | GET /v1/x/posts/get | 1 | $0.0003/次 |
| YouTube | YouTube 视频详情 | GET /v1/youtube/videos/get | 1 | $0.002/次 |
| Instagram 帖子详情 | GET /v1/instagram/posts/get | 1 | $0.004/次 | |
| Reddit 帖子详情 | GET /v1/reddit/posts/get | 1 | $0.002/次 | |
| 快手 | 快手作品详情 | GET /v1/kuaishou/videos/get | 1 | $0.002/次 |
| 知乎 | 知乎文章详情 即将上线 | GET /v1/zhihu/articles/get | 1 | $0.002/次 |
| 微信视频号 | 视频号作品详情 | GET /v1/wechat_channels/videos/get | 1 | $0.02/次 |
| 抖音 | 抖音星图视频数据报告 | GET /v1/douyin/xingtu/videos/get | 1 | $0.004/次 |
| 小红书 | 小红书视频笔记详情(视频地址) | GET /v1/xiaohongshu/videos/get | 1 | $0.02/次 |
| 微博 | 微博详情 | GET /v1/weibo/posts/get | 1 | $0.002/次 |
| YouTube | YouTube 帖子详情 | GET /v1/youtube/posts/get | 1 | $0.002/次 |
每次 $0.0003 到 $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/videos/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=7301234567890123456'
# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/notes/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=6650a1b2000000001e00abcd'常见用途
- 把投放报告里的一列链接,变成最新的播放和点赞数。
- 用户在对话里贴了一条链接,让 AI 读到全文。
- 对一条爆款每隔几小时查一次,看它还在以多快的速度增长。
常见问题
- 能直接传分享链接吗?
- 大多数平台可以:url 参数直接填内容链接,v.douyin.com、v.kuaishou.com 这类分享短链也行。公众号文章填 mp.weixin.qq.com 的链接。
- 能拿到视频文件吗?
- 大多拿不到:返回的是链接、文案、图片或封面,以及互动数据。少数接口会返回视频文件,接口页里会写明;比如视频号的 url 就是视频文件,但经过加密,密钥在同一次返回的 ext.decode_key 里。
- 内容被删了怎么办?
- 调用返回 not_found,大多数接口对此不收费,设成私密的内容也一样,所以拿一长串旧链接去查,失效的那些不花钱。少数收费的接口在 prices.json 里列着。