YouTube API

YouTube 搜索话题标签 API

按话题标签搜索 YouTube 视频,支持游标分页(标题、频道、观看次数、时长、发布时间)。

US$1.20/千次请求,按请求付费,无需订阅。

#funny - YouTube
youtube.com/hashtag/funny
YouTube
Sign in

#funny

312M videos · 28M channels

My dog reacts to the vacuum cleaner #funny

Pancake the Corgi · 4.8M views · 3 days ago

API 返回的内容videos[0]
{
"id": "dN1sTv7QkXo",
"url": "https://www.youtube.com/watch?v=dN1sTv7QkXo",
"title": "My dog reacts to the vacuum cleaner #funny",
"channelTitle": "Pancake the Corgi",
"views": 4820000,
"lengthText": "0:42",
"publishedTime": "3 days ago",
"image": "https://i.ytimg.com/vi/dN1sTv7QkXo/hqdefault.jpg",
... 还有 5 个字段
}
可用率
100.00%
30d · 178 次调用
请求数
179
30d · 按周,近 12 周
响应时间
1.5s
中位数 · 30d

价格

YouTube 搜索话题标签 API 价格

你需支付
US$12.00
US$1.20/千次请求,只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额,你的前 83 次请求免费。

试一试

一个请求获取 YouTube 搜索话题标签

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

这个示例展示了 18 个字段中的 17 个。查看全部字段

{
  "found": true,
  "data": {
    "nextCursor": "EqQCCkYaGkNva1JXVzXQ0MDA1UN0aWNraGFzaHRhZw",
    "videos": [
      {
        "id": "dN1sTv7QkXo",
        "url": "https://www.youtube.com/watch?v=dN1sTv7QkXo",
        "title": "My dog reacts to the vacuum cleaner #funny",
        "channelTitle": "Pancake the Corgi",
        "views": 4820000,
        "lengthText": "0:42",
        "publishedTime": "3 days ago",
        "image": "https://i.ytimg.com/vi/dN1sTv7QkXo/hqdefault.jpg",
        "createdUtc": 1758758400,
        "authorId": "UC3fKq1n9pRxYm2oLwVzT8Cg",
        "authorHandle": "pancakethecorgi",
        "authorAvatarUrl": "https://yt3.ggpht.com/pancake-corgi-avatar.jpg",
        "durationSeconds": 42
      },
      {
        "id": "eO2uUw8RlYp",
        "url": "https://www.youtube.com/watch?v=eO2uUw8RlYp",
        "title": "Trying to explain crypto to my grandma #funny #comedy",
        "channelTitle": "Marcus Bellweather",
        "views": 1230000,
        "lengthText": "3:15",
        "publishedTime": "1 week ago",
        "image": "https://i.ytimg.com/vi/eO2uUw8RlYp/hqdefault.jpg",
        "createdUtc": 1758326400,
        "authorId": "UC7pRq2s0mXyLn3aQwYbT4Ef",
        "authorHandle": "marcusbellweather",
        "authorAvatarUrl": "https://yt3.ggpht.com/marcus-bellweather-avatar.jpg",
        "durationSeconds": 195
      },
      {
        "id": "fP3vVx9SmZq",
        "url": "https://www.youtube.com/watch?v=fP3vVx9SmZq",
        "title": "Office prank fails compilation #funny",
        "channelTitle": "Blooper Reel Weekly",
        "views": 892000,
        "lengthText": "8:04",
        "publishedTime": "2 weeks ago",
        "image": "https://i.ytimg.com/vi/fP3vVx9SmZq/hqdefault.jpg",
        "createdUtc": 1757721600,
        "authorId": "UC5oNp8q1rXwKm0bRzUcV2Gh",
        "authorHandle": "blooperreelweekly",
        "authorAvatarUrl": "https://yt3.ggpht.com/blooper-reel-avatar.jpg",
        "durationSeconds": 484
      }
    ]
  }
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

一个请求,一种响应结构。

你发送的每个字段和收到的每个字段,都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON,POST 到这个接口。

  • hashtagstring

    funny

    要搜索的话题标签(不带开头的 #)。

  • cursorstring

    上一次响应返回的续传令牌,用于分页。

  • typeenum

    内容筛选。只处理 "all":我们采购的数据源中,没有一个会返回带有此接口所需频道和发布时间的 Shorts 结果。

你发送。 一个简短的 JSON 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

datadata
  • nextCursorstring

    EqQCCkYaGkNva1JXVzXQ0MDA1UN0aWNraGFzaHRhZw

    Opaque cursor for the next page of videos, or null when this lane has no more. Pass it back as cursor to continue.

each videodata.videos[]

Populated whenever the provider has data for the entity.

  • authorAvatarUrlstring

    https://yt3.ggpht.com/pancake-corgi-avatar.jpg

    URL of the publishing channel's avatar image.

  • authorHandlestring

    pancakethecorgi

    The publishing channel's @handle, without the leading @.

  • authorIdstring

    UC3fKq1n9pRxYm2oLwVzT8Cg

    YouTube channel ID of the publishing channel.

  • channelTitlestring

    Pancake the Corgi

    Populated whenever the provider has data for the entity.

  • createdUtcnumber

    1758758400

    UTC epoch timestamp in seconds (Unix time), estimated from the relative age YouTube shows such as "4 days ago", so it can be off by up to that label's unit (a day, a week, a month). Multiply by 1000 for a JS Date in milliseconds.

  • durationSecondsinteger

    42

    Length of the video in seconds.

  • idstring

    dN1sTv7QkXo

    Populated whenever the provider has data for the entity.

  • imagestring

    https://i.ytimg.com/vi/dN1sTv7QkXo/hqdefault.jpg

    URL of the video thumbnail image, tracking query parameters stripped.

  • lengthTextstring

    0:42

  • publishedTimestring

    3 days ago

    Populated whenever the provider has data for the entity.

  • titlestring

    My dog reacts to the vacuum cleaner #funny

    Populated whenever the provider has data for the entity.

  • urlstring

    https://www.youtube.com/watch?v=dN1sTv7QkXo

    Populated whenever the provider has data for the entity.

  • viewsinteger

    4820000

top level
  • foundboolean

    true

  • 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.

你收到。 字段有名称、有类型,无论哪个数据源响应,结构都一样。

常见问题

关于 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 秒,共测量 178 次调用。

费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

按话题标签搜索 YouTube 视频,支持游标分页(标题、频道、观看次数、时长、发布时间)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 YouTube 搜索话题标签 API 调用中有 100.0% 成功,响应时间中位数为 1.5 秒,共测量 178 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 83 次 YouTube 搜索话题标签,每次 US$0.0012。

向 https://api.getanyapi.com/v1/run/youtube.search_hashtag 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。