获取 YouTube 频道列表

GET /api/open/youtube/channels

该接口返回公开 YouTube 频道列表。每条含 youtubeCategory / categorySlugs，与 GET /api/open/categories?scope=youtube 及 GET /api/open/category-groups?module=youtube 联用，用于筛选与展示。

请求地址

GET /api/open/youtube/channels

请求参数

参数	类型	是否必传	说明
`locale`	string	否	展示语言（若存在多语言字段）
`q`	string	否	名称、简介搜索
`tag`	string	否	逗号分隔的分类 slug，用于筛选

返回体

200 OK，application/json：

字段	类型	说明
`channels`	object[]	频道列表，每项为 `YouTubeChannel`

YouTubeChannel 结构

字段	类型	说明
`channelId`	string	YouTube 频道 ID
`name`	string	频道名称
`description`	string \| undefined	频道描述
`youtubeCategory`	string[]	分类标签（展示用）
`categorySlugs`	string[]	分类 slug 列表，与 categories 的 `key` 对齐

错误码

HTTP 状态	场景
`429`	命中 open API 限流
`500`	服务器内部错误

请求示例

curl -s "https://www.web3base.ai/api/open/youtube/channels?locale=zh-hans" | jq '.channels[0]'
curl -s "https://www.web3base.ai/api/open/youtube/channels?tag=education,tutorial" | jq '.channels | length'

返回示例

{
  "channels": [
    {
      "channelId": "UCxxx",
      "name": "Web3 频道",
      "description": "区块链与 Web3 教程",
      "youtubeCategory": ["教育"],
      "categorySlugs": ["education"]
    }
  ]
}

← 返回 API 总览