YouTube API

YouTube 搜索 API

搜索 YouTube 并获取匹配的视频:标题、频道、观看次数、时长和发布时间。

POST/v1/run/youtube.search
可用率
100.00%
30d · 15,769 次调用
请求数
15,769
30d · 按周,近 12 周
响应时间
2.3s
中位数 · 30d

试一试

发出你的第一个请求

requireFieldsarray
可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `nextCursor`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个结果确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。在分页遍历中,它只作用于第一页;后续页面沿用该页选定的数据源,按当时的报价计费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "found": true,
  "data": {
    "videos": [
      {
        "id": "BzSzwqb-OEE",
        "url": "https://www.youtube.com/watch?v=BzSzwqb-OEE",
        "title": "Apollo 11 Moon Landing: Restored Footage",
        "channel": "NASA",
        "views": 14860541,
        "lengthText": "4:14",
        "publishedTime": "2 years ago"
      }
    ]
  }
}
响应类型定义
interface YoutubeSearchResponse {
  data: {
    nextCursor?: string | null;
    videos: {
      authorAvatarUrl?: string;
      authorId?: string;
      channel: string;
      createdUtc?: 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
curl -X POST https://api.getanyapi.com/v1/run/youtube.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"apollo 11 landing"}'
字段类型示例值
请求体
querystring"apollo 11 landing"YouTube 搜索词。
cursorstring上一次响应返回的续传令牌,用于分页。
requireCursorboolean已弃用;请改为发送 `requireFields: ["nextCursor"]`,效果完全相同。如果你打算翻页浏览结果,请设为 true,这样请求只会由能返回 nextCursor 的数据源处理。省略时路由不变,由最便宜的数据源处理。这可能提高你的价格:最便宜的数据源无法分页时,会由能分页的数据源处理,并按它的价格报价和扣费。该参数仍被接受,已在发送它的调用方可继续正常使用。
requireFieldsarray可选;省略时路由不变,由最便宜的数据源处理。列出本次请求必须能返回的输出字段,例如 `nextCursor`,请求就只会由能返回全部这些字段的数据源处理。未列出的字段,只要处理请求的数据源有,仍会照常返回。这可能提高你的价格:最便宜的数据源无法返回某个列出的字段时,会改由更贵的数据源处理,并按它的价格报价和扣费。如果某个结果确实没有某个列出的字段,该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回,请求会作为无效输入被拒绝,不扣费。在分页遍历中,它只作用于第一页;后续页面沿用该页选定的数据源,按当时的报价计费。
sortByenum排序方式:"relevance"(默认)或 "popular"(观看次数最多)。
uploadDateenum按上传时间筛选。省略则不限时间。
响应
foundbooleantrue
dataobject
data.videosarray
data.videos[].idstring"BzSzwqb-OEE"
data.videos[].urlstring"https://www.youtube.com/watch?v=BzSzwqb-OEE"
data.videos[].titlestring"Apollo 11 Moon Landing: Restored Footage"
data.videos[].channelstring"NASA"
data.videos[].viewsnumber14860541
data.videos[].lengthTextstring"4:14"
data.videos[].publishedTimestring"2 years ago"
价格
每次请求价格USDUS$0.0005
价格(/千次请求)USDUS$0.50

常见问题

关于 YouTube 搜索 API

AnyAPI 的 YouTube 搜索 API 只需一次 POST 请求 /v1/run/youtube.search,就以统一格式的 JSON 返回 YouTube 数据。搜索 YouTube 并获取匹配的视频:标题、频道、观看次数、时长和发布时间。AnyAPI 会在 3 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.50 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 YouTube 搜索 API 调用中有 100.0% 成功,响应时间中位数为 2.3 秒,共测量 15,769 次调用。

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

搜索 YouTube 并获取匹配的视频:标题、频道、观看次数、时长和发布时间。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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