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"}'
字段类型示例值
请求体
hashtagstring"funny"要搜索的话题标签(不带开头的 #)。
cursorstring上一次响应返回的续传令牌,用于分页。
typeenum内容筛选。只处理 "all":我们采购的数据源中,没有一个会返回带有此接口所需频道和发布时间的 Shorts 结果。
响应
dataobject
data.nextCursorstringOpaque cursor for the next page of videos, or null when this lane has no more. Pass it back as cursor to continue.
data.videosobject[]Populated whenever the provider has data for the entity.
data.videos[].authorAvatarUrlstringURL of the publishing channel's avatar image.
data.videos[].authorHandlestringThe publishing channel's @handle, without the leading @.
data.videos[].authorIdstringYouTube channel ID of the publishing channel.
data.videos[].channelTitlestringPopulated whenever the provider has data for the entity.
data.videos[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.videos[].durationSecondsintegerLength of the video in seconds.
data.videos[].idstringPopulated whenever the provider has data for the entity.
data.videos[].imagestringURL of the video thumbnail image, tracking query parameters stripped.
data.videos[].lengthTextstring
data.videos[].publishedTimestringPopulated whenever the provider has data for the entity.
data.videos[].titlestringPopulated whenever the provider has data for the entity.
data.videos[].urlstringPopulated whenever the provider has data for the entity.
data.videos[].viewsinteger
foundboolean
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.
价格
每次请求价格USDUS$0.0012
价格(/千次请求)USDUS$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 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。