# 内容详情接口

> 13 个平台的 16 个接口，用同一个 Post 对象返回内容详情。按 ID 或链接取一条内容（视频、笔记、帖子或文章）：全文、作者、发布时间、图片，以及调用那一刻的互动数据。每次 $0.0003 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。

网页版：https://okdata.online/zh/roles/posts-get/

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | [抖音视频详情](https://okdata.online/zh/apis/douyin/videos/get/) | `GET /v1/douyin/videos/get` | 1 | $0.002/次 |
| 小红书 | [小红书笔记详情](https://okdata.online/zh/apis/xiaohongshu/notes/get/) | `GET /v1/xiaohongshu/notes/get` | 1 | $0.02/次 |
| 微信公众号 | [公众号文章详情](https://okdata.online/zh/apis/wechat_mp/articles/get/) | `GET /v1/wechat_mp/articles/get` | 1 | $0.02/次 |
| B站 | [B站视频详情](https://okdata.online/zh/apis/bilibili/videos/get/) | `GET /v1/bilibili/videos/get` | 1 | $0.002/次 |
| TikTok | [TikTok 视频详情](https://okdata.online/zh/apis/tiktok/videos/get/) | `GET /v1/tiktok/videos/get` | 1 | $0.002/次 |
| X（推特） | [X 帖子详情](https://okdata.online/zh/apis/x/posts/get/) | `GET /v1/x/posts/get` | 1 | $0.0003/次 |
| YouTube | [YouTube 视频详情](https://okdata.online/zh/apis/youtube/videos/get/) | `GET /v1/youtube/videos/get` | 1 | $0.002/次 |
| Instagram | [Instagram 帖子详情](https://okdata.online/zh/apis/instagram/posts/get/) | `GET /v1/instagram/posts/get` | 1 | $0.004/次 |
| Reddit | [Reddit 帖子详情](https://okdata.online/zh/apis/reddit/posts/get/) | `GET /v1/reddit/posts/get` | 1 | $0.002/次 |
| 快手 | [快手作品详情](https://okdata.online/zh/apis/kuaishou/videos/get/) | `GET /v1/kuaishou/videos/get` | 1 | $0.002/次 |
| 知乎 | [知乎文章详情](https://okdata.online/zh/apis/zhihu/articles/get/)（即将上线） | `GET /v1/zhihu/articles/get` | 1 | $0.002/次 |
| 微信视频号 | [视频号作品详情](https://okdata.online/zh/apis/wechat_channels/videos/get/) | `GET /v1/wechat_channels/videos/get` | 1 | $0.02/次 |
| 抖音 | [抖音星图视频数据报告](https://okdata.online/zh/apis/douyin/xingtu/videos/get/) | `GET /v1/douyin/xingtu/videos/get` | 1 | $0.004/次 |
| 小红书 | [小红书视频笔记详情（视频地址）](https://okdata.online/zh/apis/xiaohongshu/videos/get/) | `GET /v1/xiaohongshu/videos/get` | 1 | $0.02/次 |
| 微博 | [微博详情](https://okdata.online/zh/apis/weibo/posts/get/) | `GET /v1/weibo/posts/get` | 1 | $0.002/次 |
| YouTube | [YouTube 帖子详情](https://okdata.online/zh/apis/youtube/posts/get/) | `GET /v1/youtube/posts/get` | 1 | $0.002/次 |

## 返回的对象：[Post](https://okdata.online/zh/docs/objects/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 时返回。 |

## 两个平台上的同一个调用

参数一样、翻页方式一样、返回结构一样，只换路径。

```bash
# 抖音
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 里列着。

## 其他数据类型

- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [热榜接口](https://okdata.online/zh/roles/trends-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [热门内容接口](https://okdata.online/zh/roles/posts-trending/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)
- [内容数据接口](https://okdata.online/zh/roles/posts-metrics/)
- [社区帖子接口](https://okdata.online/zh/roles/communities-posts-list/)
- [广告详情接口](https://okdata.online/zh/roles/ads-get/)
- [广告主广告列表接口](https://okdata.online/zh/roles/advertisers-ads-list/)
- [广告搜索接口](https://okdata.online/zh/roles/ads-search/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)
- [粉丝列表接口](https://okdata.online/zh/roles/accounts-followers-list/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品评价接口](https://okdata.online/zh/roles/products-reviews-list/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)
- [达人搜索接口](https://okdata.online/zh/roles/creators-search/)
- [达人详情接口](https://okdata.online/zh/roles/creators-get/)
- [达人粉丝画像接口](https://okdata.online/zh/roles/creators-audience-get/)