YouTube Get Channel Videos

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

VideoSocial
2.07 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
channel_idstringYes频道ID/Channel ID—
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分页token,用于获取下一页/Pagination token for next page—

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_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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.