YouTube Search Channels Legacy

2.07 credits/call
ae_youtube_search_channels_legacy

## Purpose Search YouTube channels using a channel ID and search keywords. ## Inputs - `channel_id` (required string): Channel ID. - `search_query` (required string): Search keywords. - `language_code` (optional string): Language code; defaults to `en`. - `country_code` (optional string): Country code; defaults to `us`. - `continuation_token` (optional string): Token for continuing search results. Omit it for an initial request; supply a token from earlier results when available. ## Result Returns the search response directly. The `data` field holds the search result payload and may be null. The response also includes status and message information. The result item structure and pagination-token location are not specified, so available details depend on the returned payload. Both a channel ID and search keywords are required; this is not an ID-free channel search.

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.

Each call requires a channel ID and search keyword; language code and country code are optional and default to en and us, respectively.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
channel_idstringYes频道ID/Channel ID—
country_codestringNo国家代码/Country codeus
search_querystringYes搜索关键字/Search keyword—
language_codestringNo语言代码/Language codeen
continuation_tokenstringNo翻页令牌/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_legacy' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "channel_id": "UCBMcxvIVDkbNax7py7Tx1Mg",
    "continuation_token": "4qmFsgJtEhhVQ0JNY3h2SVZEa2JOYXg3cHk3VHgxTWcaRDhnWXJHaW1hQVNZS0pEWmtORGxoWkdZekxUQXdNREF0TWpCbE5pMDROR0ZoTFRVNE1qUXlPV0UzWTJaaU9BJTNEJTNEWgtEZWx0YSBGb3JjZQ%3D%3D",
    "country_code": "us",
    "language_code": "ru",
    "search_query": "Delta Force"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "channel_id": "UCBMcxvIVDkbNax7py7Tx1Mg",
    "continuation_token": null,
    "country": "US",
    "lang": "ru",
    "number_of_videos": 0,
    "query": "Delta Force"
  },
  "docs": "https://api.tikhub.io/#/YouTube-Web-API/search_channel_api_v1_youtube_web_search_channel_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "channel_id": "UCBMcxvIVDkbNax7py7Tx1Mg",
    "continuation_token": "4qmFsgJtEhhVQ0JNY3h2SVZEa2JOYXg3cHk3VHgxTWcaRDhnWXJHaW1hQVNZS0pEWmtORGxoWkdZekxUQXdNREF0TWpCbE5pMDROR0ZoTFRVNE1qUXlPV0UzWTJaaU9BJTNEJTNEWgtEZWx0YSBGb3JjZQ%3D%3D",
    "country_code": "us",
    "language_code": "ru",
    "search_query": "Delta Force"
  }
}

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