YouTube Hashtag Videos API
收藏YouTube Hashtag Videos API 数据集详情
概述
YouTube Hashtag Videos API 允许开发者发现和检索与特定 YouTube 话题标签相关的视频。支持基于标签的搜索、视频元数据、频道信息、互动指标及趋势内容获取，适用于趋势分析、内容发现、社交媒体监控、营销研究和分析应用。
核心功能特性
- 多标签支持：单个请求支持搜索和分析多个话题标签。
- 全面的视频元数据：获取视频标题、描述、观看次数、点赞数、评论数、发布日期、频道信息等。
- 实时数据获取：提供最新的视频数据。
- 代理支持：可自主开启或关闭代理，以提升数据访问效率或绕过区域限制。
- YouTube Shorts 检测：可专门定位和提取 YouTube Shorts 数据。
- 高效批量处理：支持批量查询，处理大规模数据集。
- 详细标签分析：获取标签类别数据及关联频道数量等洞察。
- 结构化 JSON 响应：数据以清晰的结构化 JSON 格式返回，便于集成。
- 高级过滤：可选择仅抓取 Shorts 或常规视频，优化结果相关性。
端点信息
该 API 提供两个端点，均需通过 RapidAPI 密钥进行身份验证。
| 方法 | 端点路径 | 描述 | 主要限制 |
|---|---|---|---|
| GET | /v1/youtube-hashtag-videos/ |
检索与指定 YouTube 标签关联的视频。 | 每次请求最多返回 100 个视频。 |
| POST | /v1/youtube-hashtag-videos/ |
批量请求，检索与多个 YouTube 标签关联的视频。 | 每次请求最多返回 10,000 个视频。 |
GET 请求参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
hashtags |
string | 是 | 要搜索的逗号分隔的标签列表。 |
max_items |
integer | 否 | 返回的最大视频数量（默认 100）。 |
scrape_shorts_only |
boolean | 否 | 设置为 true 则仅抓取 YouTube Shorts。 |
scrape_videos_only |
boolean | 否 | 设置为 true 则仅抓取常规 YouTube 视频。 |
use_proxy |
boolean | 否 | 使用代理（默认 true）。 |
POST 请求参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
hashtags |
array | 是 | 不含 # 的标签数组。 |
max_items |
integer | 否 | 返回的最大视频数量（上限 10,000）。 |
scrape_shorts_only |
boolean | 否 | 设置为 true 则仅抓取 Shorts。 |
scrape_videos_only |
boolean | 否 | 设置为 true 则仅抓取常规视频。 |
use_proxy |
boolean | 否 | 使用代理（默认 true）。 |
响应示例
json [ { "id": "2tdmUBMw-a4", "scraped_at": "2025-12-23T18:15:00.000Z", "title": "chatgpt photo editing kaise kare", "description": "", "url": "https://www.youtube.com/watch?v=2tdmUBMw-a4", "viewCount": 1267820, "likes": 0, "comment_count": 0, "hashtagUrl": "https://www.youtube.com/hashtag/chatgpt", "thumbnailUrl": "https://i.ytimg.com/vi/2tdmUBMw-a4/hqdefault.jpg", "type": "video", "date": "8 months ago", "order": 0, "hashtagCategoryData": { "categoryInfoText": "2.2M videos • 665K channels", "videosCount": 2200000, "channelsCount": 665000 }, "channel": { "name": "tipu tw Vlogs", "url": "http://www.youtube.com/channel/UCiQqq0jEhfhOJsoY6ZhTufw" } } ]
技术规格
- 支持方法：GET, POST
- 认证方式：请求头中包含 RapidAPI 密钥
- 速率限制：取决于 RapidAPI 订阅计划
- 响应格式：JSON
- 错误码：400（缺少参数）、429（超出速率限制）、504（网关超时）
最佳用例
- 营销与广告：识别趋势标签，优化广告定向。
- 内容创作者与影响者：发现热门内容主题。
- 数据分析师：分析视频表现和标签有效性。
- 社交媒体经理：追踪标签使用情况和受众互动。
- SEO 专家：分析与特定标签关联的内容可见性。
- 媒体研究员：研究内容增长模式与病毒式传播趋势。
