v0.2.0-beta

OpenAPI 3.1.0

YouTube 搜索

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search 操作

get/v1/beta/youtube/search

YouTube 搜索

在 YouTube 上搜索视频、频道和播放列表。engine=youtube 和 q 为必填项。使用 gl 和 hl 指定国家/地区和语言，或使用 sp 进行分页和高级筛选。

计费参考

计量方式：按成功请求的固定成本计费。
参考请求估算：0.0029 美元。
参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

查询参数

engine
枚举
常量:
youtube
必填

SearchApi 引擎标识符。此 YouTube 端点请使用 youtube。
值
- youtube
gl
类型: string

国家代码（例如 us、jp）
hl
类型: string

界面语言
q
类型: string
必填

搜索查询。运行时和上游 SearchApi 均要求提供。
sp
类型: string

YouTube 筛选令牌（分页或高级筛选）

响应

200
类型: object · ResponseFc5Af1Fcba22_SearchResponse

成功响应
ads
类型: array object[] · ResponseFc5Af1Fcba22_Ad[]

广告结果

channel
类型: object · ResponseFc5Af1Fcba22_AdChannel
id
类型: string

频道 ID

link
类型: string

频道链接

title
类型: string

频道名称

description
类型: string

广告描述

id
类型: string

视频广告的视频 ID

length
类型: string

视频广告的视频时长

link
类型: string

广告链接

position
类型: integer

搜索结果中的位置

thumbnail
类型: string

广告缩略图 URL

title
类型: string

广告标题

website
类型: string

广告主网站 URL

channels
类型: array object[] · ResponseFc5Af1Fcba22_Channel[]

YouTube 频道结果

description
类型: string

频道描述

id
类型: string

YouTube 频道 ID

is_verified
类型: boolean

频道是否已验证

link
类型: string

频道链接

position
类型: integer

搜索结果中的位置

subscribers
类型: integer

订阅者数

thumbnail
类型: object · ResponseFc5Af1Fcba22_Thumbnail
rich
类型: string

富媒体/动画缩略图 URL

static
类型: string

静态缩略图 URL

title
类型: string

频道名称

video_count
类型: integer

视频数

error
类型: string

搜索失败时的错误消息

featured_channel
类型: object · ResponseFc5Af1Fcba22_FeaturedChannel
highlighted_video
类型: object · ResponseFc5Af1Fcba22_HighlightedVideo
id
类型: string

视频 ID

length
类型: string

视频时长

link
类型: string

视频链接

subtitle
类型: string

视频副标题

title
类型: string

视频标题

id
类型: string

精选频道 ID

link
类型: string

精选频道链接

subtitle
类型: string

精选频道副标题

title
类型: string

精选频道标题

videos
类型: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

精选频道视频

channel
类型: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
类型: string

频道 ID

link
类型: string

频道链接

title
类型: string

频道名称

id
类型: string

视频 ID

length
类型: string

视频时长

link
类型: string

视频链接

subtitle
类型: string

视频副标题

thumbnail
类型: string

视频缩略图 URL

title
类型: string

视频标题

movies
类型: array object[] · ResponseFc5Af1Fcba22_Movie[]

电影结果

badges
类型: array string[]

电影徽章

buttons
类型: array string[]

操作按钮

channel
类型: object · ResponseFc5Af1Fcba22_MovieChannel
id
类型: string

频道 ID

is_verified
类型: boolean

频道是否已验证

link
类型: string

频道链接

title
类型: string

频道名称

description
类型: string

电影描述

id
类型: string

电影视频 ID

length
类型: string

电影时长

link
类型: string

电影链接

metadata_items
类型: object · ResponseFc5Af1Fcba22_MetadataItems
bottom
类型: array string[]

底部元数据项

top
类型: array string[]

顶部元数据项

position
类型: integer

搜索结果中的位置

thumbnail
类型: string

电影缩略图 URL

title
类型: string

电影标题

pagination
类型: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
类型: string

获取下一页结果的令牌

people_also_search_for
类型: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

相关搜索建议

link
类型: string

执行搜索的链接

query
类型: string

建议的搜索查询

thumbnail
类型: string

建议项的缩略图

playlists
类型: array object[] · ResponseFc5Af1Fcba22_Playlist[]

播放列表结果

channel
类型: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
类型: string

频道 ID

is_verified
类型: boolean

频道是否已验证

link
类型: string

频道链接

title
类型: string

频道名称

id
类型: string

播放列表 ID

link
类型: string

播放列表链接

position
类型: integer

搜索结果中的位置

published_time
类型: string

发布后经过的时间

thumbnail
类型: string

播放列表缩略图 URL

title
类型: string

播放列表标题

video_count
类型: integer

播放列表中的视频数

videos
类型: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

播放列表中的视频

id
类型: string

视频 ID

length
类型: string

视频时长

link
类型: string

视频链接

title
类型: string

视频标题

posts
类型: array object[] · ResponseFc5Af1Fcba22_Posts[]

社区帖子结果

items
类型: array object[] · ResponseFc5Af1Fcba22_Post[]

社区帖子

channel
类型: object · ResponseFc5Af1Fcba22_PostChannel
id
类型: string

频道 ID

is_verified
类型: boolean

频道是否已验证

link
类型: string

频道链接

thumbnail
类型: string

频道缩略图 URL

title
类型: string

频道名称

comments
类型: string

评论数的文本形式

extracted_comments
类型: integer

以整数表示的评论数

extracted_likes
类型: integer

以整数表示的点赞数

id
类型: string

帖子 ID

likes
类型: string

点赞数的文本形式

link
类型: string

帖子链接

position
类型: integer

在帖子区块中的位置

published_time
类型: string

发布后经过的时间

text
类型: string

帖子文本内容

thumbnail
类型: string

帖子缩略图 URL

position
类型: integer

搜索结果中的位置

section_title
类型: string

帖子区块标题

search_information
类型: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
类型: string

应用拼写修正后的查询

original_query
类型: string

修正前的原始查询

original_query_sp
类型: string

原始查询的 SP 参数

state
类型: string

查询修正的状态（如适用）

total_results
类型: integer

找到的结果总数

search_metadata
类型: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
类型: string 格式: date-time
必填

搜索创建时间戳

id
类型: string
必填

搜索请求的唯一标识符

status
类型: string
必填

搜索请求的状态

html_url
类型: string

查看 HTML 结果的 URL

json_url
类型: string

查看 JSON 结果的 URL

parsing_time_taken
类型: number

解析结果所用时间（秒）

request_time_taken
类型: number

发起请求所用时间（秒）

request_url
类型: string

本次搜索的 YouTube URL

total_time_taken
类型: number

搜索总耗时（秒）

search_parameters
类型: object · ResponseFc5Af1Fcba22_SearchParameters
engine
类型: string

使用的搜索引擎

gl
类型: string

使用的国家/地区代码

hl
类型: string

使用的界面语言

q
类型: string

使用的搜索查询

sp
类型: string

使用的筛选/分页参数

sections
类型: array object[] · ResponseFc5Af1Fcba22_Section[]

区块结果

items
类型: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

区块中的项目

channel
类型: object · ResponseFc5Af1Fcba22_SectionChannel
id
类型: string

频道 ID

link
类型: string

频道链接

title
类型: string

频道名称

id
类型: string

项目 ID

length
类型: string

项目时长

link
类型: string

项目链接

published_time
类型: string

发布后经过的时间

thumbnail
类型: string

项目缩略图 URL

title
类型: string

项目标题

views
类型: integer

观看次数

position
类型: integer

搜索结果中的位置

section_title
类型: string

区块标题

shorts
类型: array object[] · ResponseFc5Af1Fcba22_Shorts[]

YouTube Shorts 结果

items
类型: array object[] · ResponseFc5Af1Fcba22_Short[]

Shorts 短视频

duration
类型: string

Shorts 时长

id
类型: string

Shorts 视频 ID

link
类型: string

Shorts 链接

position
类型: integer

在 Shorts 区块中的位置

thumbnail
类型: string

Shorts 缩略图 URL

title
类型: string

Shorts 标题

views
类型: integer

观看次数

position
类型: integer

搜索结果中的位置

section_title
类型: string

Shorts 区块标题

suggestions
类型: array string[]

搜索查询建议

videos
类型: array object[] · ResponseFc5Af1Fcba22_Video[]

视频搜索结果

badges
类型: array string[]

视频徽章

channel
类型: object · ResponseFc5Af1Fcba22_VideoChannel
id
类型: string

频道 ID

is_verified
类型: boolean

频道是否已验证

link
类型: string

频道链接

thumbnail
类型: string

频道缩略图 URL

title
类型: string

频道名称

description
类型: string

视频描述片段

id
类型: string

YouTube 视频 ID

is_live
类型: boolean

视频当前是否为直播

key_moments
类型: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

视频中的关键时刻

start_seconds
类型: integer

该时刻的起始时间（秒）

thumbnail
类型: string

关键时刻缩略图 URL

title
类型: string

关键时刻标题

length
类型: string

视频时长

link
类型: string

视频链接

position
类型: integer

搜索结果中的位置

published_time
类型: string

发布后经过的时间

thumbnail
类型: object · ResponseFc5Af1Fcba22_Thumbnail
rich
类型: string

富媒体/动画缩略图 URL

static
类型: string

静态缩略图 URL

title
类型: string

视频标题

views
类型: integer

观看次数
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

由于未满足计费要求，请求无法继续。
403

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

错误响应；上游透传响应可能采用提供方格式

application/json

get/v1/beta/youtube/search

curl 'https://openapi.felo.ai/v1/beta/youtube/search?engine=youtube&q=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

显示 Schema

{
  "search_metadata": {
    "id": "string",
    "status": "string",
    "created_at": "2026-10-26T08:08:16.601Z",
    "request_time_taken": 1,
    "parsing_time_taken": 1,
    "total_time_taken": 1,
    "request_url": "string",
    "html_url": "string",
    "json_url": "string"
  },
  "search_parameters": {
    "engine": "string",
    "q": "string",
    "sp": "string",
    "hl": "string",
    "gl": "string"
  },
  "search_information": {
    "total_results": 1,
    "state": "string",
    "original_query": "string",
    "original_query_sp": "string",
    "corrected_query": "string"
  },
  "suggestions": [
    "string"
  ],
  "ads": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "website": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string"
      },
      "length": "string",
      "thumbnail": "string"
    }
  ],
  "channels": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "is_verified": true,
      "video_count": 1,
      "subscribers": 1,
      "thumbnail": {
        "static": "string",
        "rich": "string"
      }
    }
  ],
  "movies": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true
      },
      "length": "string",
      "metadata_items": {
        "top": [
          "string"
        ],
        "bottom": [
          "string"
        ]
      },
      "badges": [
        "string"
      ],
      "buttons": [
        "string"
      ],
      "thumbnail": "string"
    }
  ],
  "videos": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "views": 1,
      "is_live": true,
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true,
        "thumbnail": "string"
      },
      "length": "string",
      "published_time": "string",
      "badges": [
        "string"
      ],
      "thumbnail": {
        "static": "string",
        "rich": "string"
      },
      "key_moments": [
        {
          "title": "string",
          "start_seconds": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "playlists": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "video_count": 1,
      "channel": {
        "id": "string",
        "title": "string",
        "is_verified": true,
        "link": "string"
      },
      "published_time": "string",
      "videos": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "length": "string"
        }
      ],
      "thumbnail": "string"
    }
  ],
  "sections": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string"
          },
          "views": 1,
          "published_time": "string",
          "length": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "shorts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "title": "string",
          "link": "string",
          "duration": "string",
          "views": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "posts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "link": "string",
          "text": "string",
          "likes": "string",
          "extracted_likes": 1,
          "comments": "string",
          "extracted_comments": 1,
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string",
            "is_verified": true,
            "thumbnail": "string"
          },
          "published_time": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "people_also_search_for": [
    {
      "query": "string",
      "link": "string",
      "thumbnail": "string"
    }
  ],
  "featured_channel": {
    "id": "string",
    "title": "string",
    "subtitle": "string",
    "link": "string",
    "highlighted_video": {
      "id": "string",
      "title": "string",
      "subtitle": "string",
      "link": "string",
      "length": "string"
    },
    "videos": [
      {
        "id": "string",
        "title": "string",
        "subtitle": "string",
        "link": "string",
        "length": "string",
        "channel": {
          "id": "string",
          "title": "string",
          "link": "string"
        },
        "thumbnail": "string"
      }
    ]
  },
  "pagination": {
    "next_page_token": "string"
  },
  "error": "string"
}

成功响应

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

YouTube 搜索

身份验证Required

YouTube Search

YouTube 搜索

计费参考

需要帮助？