YouTube API
YouTube 搜索话题标签 API
按话题标签搜索 YouTube 视频,支持游标分页(标题、频道、观看次数、时长、发布时间)。
POST/v1/run/youtube.search_hashtag
可用率
100.00%
30d · 16 次调用
请求数
16
30d · 按周,近 12 周
响应时间
1.5s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"nextCursor": "example",
"videos": [
{
"authorAvatarUrl": "https://example.com/image.jpg",
"authorHandle": "alex_rivera",
"authorId": "Alex Rivera",
"channelTitle": "Example title",
"createdUtc": 12.5,
"durationSeconds": 13,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"lengthText": "A short example description of this item.",
"publishedTime": "2024-01-15T09:30:00Z",
"title": "Example title",
"url": "https://example.com/page",
"views": 12500
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface YoutubeSearchHashtagResponse {
data: {
nextCursor: string | null;
videos: {
authorAvatarUrl?: string;
authorHandle?: string;
authorId?: string;
channelTitle: string;
createdUtc?: number;
durationSeconds?: number;
id: string;
image?: string;
lengthText: string;
publishedTime: string;
title: string;
url: string;
views: number;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/youtube.search_hashtag
curl -X POST https://api.getanyapi.com/v1/run/youtube.search_hashtag \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag":"funny"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| hashtag | string | "funny"要搜索的话题标签(不带开头的 #)。 |
| cursor | string | 上一次响应返回的续传令牌,用于分页。 |
| type | enum | 内容筛选。只处理 "all":我们采购的数据源中,没有一个会返回带有此接口所需频道和发布时间的 Shorts 结果。 |
| 响应 | ||
| data | object | |
| data.nextCursor | string | Opaque cursor for the next page of videos, or null when this lane has no more. Pass it back as cursor to continue. |
| data.videos | object[] | Populated whenever the provider has data for the entity. |
| data.videos[].authorAvatarUrl | string | URL of the publishing channel's avatar image. |
| data.videos[].authorHandle | string | The publishing channel's @handle, without the leading @. |
| data.videos[].authorId | string | YouTube channel ID of the publishing channel. |
| data.videos[].channelTitle | string | Populated whenever the provider has data for the entity. |
| data.videos[].createdUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.videos[].durationSeconds | integer | Length of the video in seconds. |
| data.videos[].id | string | Populated whenever the provider has data for the entity. |
| data.videos[].image | string | URL of the video thumbnail image, tracking query parameters stripped. |
| data.videos[].lengthText | string | |
| data.videos[].publishedTime | string | Populated whenever the provider has data for the entity. |
| data.videos[].title | string | Populated whenever the provider has data for the entity. |
| data.videos[].url | string | Populated whenever the provider has data for the entity. |
| data.videos[].views | integer | |
| found | boolean | |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0012 |
| 价格(/千次请求) | USD | US$1.20 |
常见问题
关于 YouTube 搜索话题标签 API
AnyAPI 的 YouTube 搜索话题标签 API 只需一次 POST 请求 /v1/run/youtube.search_hashtag,就以统一格式的 JSON 返回 YouTube 数据。按话题标签搜索 YouTube 视频,支持游标分页(标题、频道、观看次数、时长、发布时间)。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 YouTube 搜索话题标签 API 调用中有 100.0% 成功,响应时间中位数为 1.5 秒,共测量 16 次调用。
费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
按话题标签搜索 YouTube 视频,支持游标分页(标题、频道、观看次数、时长、发布时间)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 YouTube 搜索话题标签 API 调用中有 100.0% 成功,响应时间中位数为 1.5 秒,共测量 16 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。
更多接口
YouTube 的其他接口
频道/千次请求 US$0.50 起视频/千次请求 US$0.90 起视频转录文本/千次请求 US$0.90 起搜索/千次请求 US$0.50 起频道视频/千次请求 US$0.50 起视频评论/千次请求 US$1.20 起频道社区帖子/千次请求 US$1.20 起频道联系方式/千次请求 US$71.80 起频道直播/千次请求 US$1.20 起频道播放列表/千次请求 US$1.20 起频道 Shorts/千次请求 US$1.20 起评论回复/千次请求 US$1.20 起社区帖子/千次请求 US$1.20 起播放列表/千次请求 US$1.20 起搜索 Shorts/千次请求 US$1.20 起热门 Shorts/千次请求 US$1.20 起视频赞助商/千次请求 US$1.20 起视频转录文本(完整版)/千次请求 US$1.00 起