YouTube Get Channel Videos
## Get YouTube channel videos Retrieve one page of a channel's video listing, with optional language and region preferences. Use the returned pagination token to request additional pages. ### Inputs - **channel_id** (required string): The actual YouTube channel ID, for example `UCJHBJ7F-nAIlMGolm0Hu4vg`. Extract it from a `/channel/ID` URL. If you only have an `@handle`, obtain its channel ID first; do not pass the handle or full URL as this value. - **language_code** (optional string; default `zh-CN`): Language preference, such as `en-US`, `ja-JP`, or `ko-KR`. - **country_code** (optional string; default `US`): Region code, such as `US`, `JP`, or `GB`. - **continuation_token** (optional string): Copy the token from the previous response to retrieve the next page. Omit it for the first page. - **need_format** (optional boolean; default `true`): Return cleaned, simplified listing data when `true`, or raw data when `false`. ### Results The response's `data` contains the listing. With `need_format=true`: - **videos**: Video entries containing IDs, titles, thumbnail links, duration and accessibility text, view-count text, published-time text, live status, verification information, video-page URLs, and playback initialization URLs. - **channel**: First-page channel metadata, including ID, name, bio (`description`), handle URL, avatar, homepage and RSS links, keywords, family-safety status, and verification status. - **continuation_token**: The token for requesting another page when available. A single call does not retrieve all channel videos. ### Important limitations Save the first page's `channel` metadata: later pages omit it. On later pages, `videos[].is_verified` is always `false` and is not a reliable verification indicator; use the first page's channel-level value instead. In the documented lockup listing format, `videos[].description` is always `""`; use `channel.description` for the channel bio and separate video-detail retrieval for individual video descriptions. In that format, `short_view_count` duplicates `view_count` for compatibility. View counts and published times are display text rather than normalized numeric counts or timestamps.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Each call retrieves one page of videos. Each subsequent page requested with a pagination token is charged as a separate call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
channel_id | string | Yes | 频道ID/Channel ID | — |
need_format | boolean | No | 是否需要清洗数据,提取关键内容,移除冗余数据/Whether to clean and format the data | true |
country_code | string | No | 国家代码(如US, JP等)/Country code | US |
language_code | string | No | 语言代码(如zh-CN, en-US等)/Language code | zh-CN |
continuation_token | string | No | 分页token,用于获取下一页/Pagination token for next page | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_youtube_get_channel_videos' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"channel_id": "UCvJlhnlD0ASLijTgRsUYi5A",
"country_code": "ES",
"language_code": "es-ES",
"need_format": true
}
}'{
"code": 200,
"data": {
"channel": {
"avatar": "https://yt3.googleusercontent.com/JPTeR9L9WgrjunQfMT8LpmnnHBCxO1p6GJHPrnh1QKCsGfEIT-4t8Lx3Da3ktxbDA3_NvQ4P=s900-c-k-c0x00ffffff-no-rj",
"description": "⚽🎙️ Fútbol, historias y conversaciones sin filtro.\nAlan D10Z llega a YouTube con entrevistas, actualidad, opinión y mucho contenido dentro y fuera de las canchas. \n📺 De la radio, la televisión y las canchas… ahora también en YouTube.\n¡Nos vemos en la call",
"handle_url": "http://www.youtube.com/@AlanD10Z",
"id": "UCvJlhnlD0ASLijTgRsUYi5A",
"name": "ALAN D10Z",
"url": "https://www.youtube.com/channel/UCvJlhnlD0ASLijTgRsUYi5A"
},
"continuation_token": null,
"videos": [
{
"description": "",
"duration": "12:21",
"duration_accessibility": "12 minutos y 21 segundos",
"is_live": false,
"title": " ¡EL TÍO ANORRIS SE FUE DE PROCESIÓN! 🙏💜 Alan Diez en la iglesia Las Nazarenas",
"url": "https://www.youtube.com/watch?v=xe04y7BIAkE"
}
]
},
"docs": "https://api.tikhub.io/#/YouTube-Web-V2-API/get_channel_videos_api_v1_youtube_web_v2_get_channel_videos_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"channel_id": "UCvJlhnlD0ASLijTgRsUYi5A",
"country_code": "ES",
"language_code": "es-ES",
"need_format": "true"
}
}This example shows part of the response. Copied content is valid JSON.

