YouTube Get Channel Description

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
channel_idstringNo频道ID(格式如:UCeu6U67OzJhV1KwBansH3Dg),可通过get_channel_id接口从频道URL获取/Channel ID, can be obtained from channel URL via get_channel_id endpoint—
need_formatbooleanNo是否需要清洗数据,提取关键内容,移除冗余数据/Whether to clean and format the datatrue
country_codestringNo国家代码(如US, JP等)/Country codeUS
language_codestringNo语言代码(如zh-CN, en-US等)/Language codezh-CN
continuation_tokenstringNo翻页标志(用于获取频道注册时间等高级信息)/Continuation token for getting advanced info like channel creation date—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.