YouTube Search Channels Structured

2.07 credits/call
ae_youtube_search_channels_structured

## Search YouTube channels Find channels matching a search term. Results contain channels only, not videos or playlists, and support pagination. ### Inputs - `keyword`: Search term, up to 200 characters. Required for the first request; optional when continuing with a pagination token. - `continuation_token`: Token returned by the previous page. Omit for the first request and pass it to retrieve the next page. - `need_format`: Defaults to `true` for structured channel information. Set to `false` to receive raw `channelRenderer` objects in the channel list. ### Results Result data includes `keyword`, `channels`, `continuation_token`, `has_more`, and `total_count`. `total_count` is the number of channels on the current page, not the total number of matching channels. `has_more` indicates whether more channels are available; use the returned token for the next request and stop when `has_more` is false. With `need_format=true`, channel entries include `channel_id` (identifier), `title` (name), `handle`, `subscriber_count_text` (display text rather than a numeric count), `description` (snippet), `thumbnails`, `is_subscribed` (reported subscription state), `canonical_url` (channel URL path), and `channel_url` (full URL, preferring a custom URL). With `need_format=false`, `channels` instead contains raw channel objects; the pagination fields retain the same meaning. Pages typically contain 10–20 channels, but the number and order of results are determined by YouTube and are not guaranteed. Example first request: `{"keyword":"Rick Astley"}`.

Social
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.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
keywordstring | nullNo搜索关键词/Search keyword—
need_formatbooleanNo是否格式化数据/Whether to format datatrue
continuation_tokenstringNo分页token/Pagination token—

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_search_channels_structured' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "fútbol análisis",
    "need_format": true
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "channels": [
      {
        "canonical_url": "/@analisisscouting",
        "channel_id": "UCTvamASD6RV9tNdPpne0ESg",
        "channel_url": "https://www.youtube.com/@analisisscouting",
        "description": "Analista Táctico y Scout de futbolistas con más de 10 años de experiencia. Todas las grabaciones en cancha y las ediciones de ...",
        "handle": "@analisisscouting",
        "title": "Futbol Analisis y Scouting"
      }
    ],
    "has_more": false,
    "keyword": "fútbol análisis",
    "total_count": 1
  },
  "docs": "https://api.tikhub.io/#/YouTube-Web-V2-API/search_channels_api_v1_youtube_web_v2_search_channels_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.