YouTube Get Channel Description
Retrieve a YouTube channel's description, profile details, and channel statistics. ### Inputs - Provide `channel_id` for the initial request, or `continuation_token` from the initial response for the follow-up request. One of these is required. - `channel_id` is typically a 24-character string starting with `UC`. If you only have a channel URL, resolve it to a channel ID first; this input is not a URL. - `need_format` (optional, default `true`): return cleaned, simplified data. Set to `false` for raw data. - `language_code` (optional, default `zh-CN`): preferred display language, such as `en-US` or `ja-JP`. - `country_code` (optional, default `US`): region code, such as `US`, `JP`, or `GB`. ### Results and two-request workflow 1. Call with `channel_id` to get basic details such as channel title, handle, description, subscriber and video counts, avatar, banner, channel URLs, and a `continuation_token`. 2. Use that returned `continuation_token` in a second call to get additional About information, including creation date, social links, country, and total view count. Complete channel information requires both requests; results are not automatically combined. With cleaned output, fields such as `subscriber_count`, `video_count`, and `view_count` can be display strings rather than numbers, and dates can be localized text. Some fields can be null or empty: for example, the first response may lack creation date and social links, while the follow-up may lack title, avatar, or banner. Retain populated details from both responses when combining them. A continuation token retrieves additional channel information; it is not a background-task identifier.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Each call has a fixed charge of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.
Retrieving complete channel details requires two requests: first use the channel ID to retrieve basic information, then use the returned continuation_token to retrieve supplementary details. Each request is charged separately, and the tool does not automatically merge the results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
channel_id | string | No | 频道ID(格式如:UCeu6U67OzJhV1KwBansH3Dg),可通过get_channel_id接口从频道URL获取/Channel ID, can be obtained from channel URL via get_channel_id endpoint | — |
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 | 翻页标志(用于获取频道注册时间等高级信息)/Continuation token for getting advanced info like channel creation date | — |
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_description' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"channel_id": "UCKMphC2SrLNVnLY9mgvXTkw",
"country_code": "ES",
"language_code": "es-ES",
"need_format": true
}
}'{
"code": 200,
"data": {
"avatar": [
{
"height": 900,
"url": "https://yt3.googleusercontent.com/B48LmSCKRshEEfJ0i5RZg7_gd6-uRREFYhma2Up4f8RVmMRm-s8CIackG2QPWdyIuIoZ65IDBSs=s900-c-k-c0x00ffffff-no-rj",
"width": 900
}
],
"banner": [
{
"height": 175,
"url": "https://yt3.googleusercontent.com/fF-iHht14tpoQG5cZQvFgO1XD5iaINYfoEPkCThR3hzM6J6HqdFKYQEQbFjXF9n4hbcNzhg0ag=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
"width": 1060
}
],
"channel_id": "UCKMphC2SrLNVnLY9mgvXTkw",
"channel_url": "https://www.youtube.com/channel/UCKMphC2SrLNVnLY9mgvXTkw",
"continuation_token": "4qmFsgJgEhhVQ0tNcGhDMlNyTE5WbkxZOW1ndlhUa3caRDhnWXJHaW1hQVNZS0pEWmlOemxrWWpZeExUQXdNREF0TWpFd1lpMWhNMlExTFRBME1EQTJaVFprWVdFeE1BJTNEJTNE",
"title": "Lluna Clark"
},
"docs": "https://api.tikhub.io/#/YouTube-Web-V2-API/get_channel_description_api_v1_youtube_web_v2_get_channel_description_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"channel_id": "UCKMphC2SrLNVnLY9mgvXTkw",
"country_code": "ES",
"language_code": "es-ES",
"need_format": "true"
}
}This example shows part of the response. Copied content is valid JSON.

