# 字幕接口

> 4 个平台的 4 个接口，用同一个 Transcript 对象返回字幕。视频里说了什么，按时间分段返回，同时给出整段纯文本，并注明返回的字幕语言。每次 $0.002 到 $0.004，各接口按自己的价格计费；失败的调用不扣费。

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

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| YouTube | [YouTube 视频字幕](https://okdata.online/zh/apis/youtube/videos/transcript/get/) | `GET /v1/youtube/videos/transcript/get` | 1 | $0.004/次 |
| Instagram | [Instagram 视频字幕](https://okdata.online/zh/apis/instagram/posts/transcript/get/) | `GET /v1/instagram/posts/transcript/get` | 1 | $0.004/次 |
| Reddit | [Reddit 视频字幕](https://okdata.online/zh/apis/reddit/posts/transcript/get/) | `GET /v1/reddit/posts/transcript/get` | 1 | $0.004/次 |
| TikTok | [TikTok 视频字幕](https://okdata.online/zh/apis/tiktok/videos/transcript/get/) | `GET /v1/tiktok/videos/transcript/get` | 1 | $0.002/次 |

## 返回的对象：[Transcript](https://okdata.online/zh/docs/objects/transcript/)

上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。

| 字段 | 类型 | 含义 |
|---|---|---|
| `video_id` | `string` | 视频 ID。 |
| `lang` | `string` | 字幕语言。 |
| `segments` | `Segment[]` | 按时间排列的字幕段。 |
| `text` | `string` | 全部字幕拼成的纯文本。 |

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

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

```bash
# YouTube
curl -G "https://api.okdata.online/v1/youtube/videos/transcript/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=dQw4w9WgXcQ'

# Instagram
curl -G "https://api.okdata.online/v1/instagram/posts/transcript/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=DeCPVhERA8e'
```

## 常见用途

- 不看视频也能总结长视频的内容。
- 把一个频道的演讲建成索引，用于搜索或 RAG 问答。
- 从一批测评视频里找出提到某个产品的每一处。

## 常见问题

### 视频没有字幕怎么办？

调用返回 not_found，不扣费。Instagram 的接口只支持两分钟以内的视频；各平台的限制写在对应的接口页上。

### 能指定语言吗？

YouTube 可以用 lang 指定想要的字幕语言，结果里的 lang 是实际拿到的那一条。其他平台返回它们现有的字幕。

### 有时间戳吗？

有。segments 里每一段都有开始、结束时间（秒）和文字，text 是全部拼起来的纯文本，既能引用某个时刻，也能整段交给模型。

## 其他数据类型

- [评论接口](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-get/)
- [内容搜索接口](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/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/)