# YouTube数据接口与 API

YouTube API 能力一览：可用接口、按次价格、翻页方式和已知限制，供 AI Agent 直接调用。

规范地址: https://socialtoai.com/zh/platforms/youtube/

## 选择下一个调用

下方每个可用操作都使用同一套核心响应结构。价格和参数支持以当前参考卡为准。

| 平台 | 动作 | Credits | 可用性 |
|---|---|---|---|
| YouTube | [search](https://socialtoai.com/zh/youtube-search-api/) | 0.3 | 可用 |
| YouTube | [trending](https://socialtoai.com/zh/youtube-trending-api/) | 0.2 | 可用 |
| YouTube | [detail](https://socialtoai.com/zh/youtube-detail-api/) | 0.2 | 可用 |
| YouTube | [comments](https://socialtoai.com/zh/youtube-comments-api/) | 0.2 | 可用 |
| YouTube | [user_profile](https://socialtoai.com/zh/youtube-user-profile-api/) | 0.2 | 可用 |
| YouTube | [user_posts](https://socialtoai.com/zh/youtube-user-posts-api/) | 0.2 | 可用 |

## 已知边界

内容搜索返回视频，用户搜索返回频道，不含播放列表和电影。用户查找支持 relevance/all；不支持的内容筛选会产生 warning。

作品请使用 11 位视频 ID 或标准 watch、shorts、youtu.be 链接。频道资料和作品需要 UC 开头的频道 ID 或 /channel/ 链接，不支持 @handle。

查看回复需要同时提供 reply_of 和该评论分支返回的 cursor。

热榜目前仅支持 Gaming 分类，不声明其他分类可用。

count 只裁剪投影后的结果。加密 cursor 会保留剩余条目，相邻重复条目会被省略并附带 warning。