Public YouTube channel list with categories; search and filter by category.
Get YouTube channels list
GET /api/open/youtube/channels
Returns the public YouTube channel list. Each item has youtubeCategory / categorySlugs; use with GET /api/open/categories?scope=youtube and GET /api/open/category-groups?module=youtube for filtering and display.
Endpoint
GET /api/open/youtube/channels
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
locale | string | No | Display language when i18n fields exist |
q | string | No | Search by name, description |
tag | string | No | Comma-separated category slugs for filtering |
Response
200 OK, application/json:
| Field | Type | Description |
|---|---|---|
channels | object[] | List of YouTubeChannel |
YouTubeChannel
| Field | Type | Description |
|---|---|---|
channelId | string | YouTube channel ID |
name | string | Channel name |
description | string | undefined | Channel description |
youtubeCategory | string[] | Category labels (display) |
categorySlugs | string[] | Category slugs, aligned with categories key |
Errors
| HTTP status | When |
|---|---|
429 | Open API rate limit |
500 | Server error |
Example request
curl -s "https://www.web3base.ai/api/open/youtube/channels?locale=en" | jq '.channels[0]'
curl -s "https://www.web3base.ai/api/open/youtube/channels?tag=education,tutorial" | jq '.channels | length'Example response
{
"channels": [
{
"channelId": "UCxxx",
"name": "Web3 Channel",
"description": "Blockchain and Web3 tutorials",
"youtubeCategory": ["Education"],
"categorySlugs": ["education"]
}
]
}