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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
channel_id | string | Yes | 频道ID/Channel ID | — |
country_code | string | No | 国家代码/Country code | us |
search_query | string | Yes | 搜索关键字/Search keyword | — |
language_code | string | No | 语言代码/Language code | en |
continuation_token | string | No | 翻页令牌/Pagination token | — |
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_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"
}
}'{
"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.

