YouTube Search Videos
## Purpose Search YouTube videos by keyword, with optional language, country, time-based search options, and pagination. ## Inputs - `search_query` (required string): Search keyword, for example `Minecraft`. - `language_code` (optional string): Language code; defaults to `en`. - `country_code` (optional string): Country code; defaults to `us`. - `order_by` (optional string): Time-based search option. Defaults to `this_month`; documented values are `this_week`, `this_month`, `this_year`, `last_hour`, and `today`. - `continuation_token` (optional string): Token for continuing search results. Omit for the first request; when a search response provides a continuation token, use it to request another page. ## Returns Returns the search response directly, with search results in `data`. The documented response schema does not specify individual video fields. This tool searches for videos; it does not download video files. ## Example `{"search_query":"Minecraft"}`
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.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.
Fetching the next page with a continuation token is a new call and is charged per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
order_by | string | No | 排序方式/Order by | this_month |
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_videos' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"order_by": "this_year",
"search_query": "AL Brooks price action"
}
}'{
"code": 200,
"data": {
"continuation_token": "ErUFEhZBTCBCcm9va3MgcHJpY2UgYWN0aW9uGowDRWdRSUJSQUJTQlNDQVF0aFUwOXdSRzlrVVhwbmM0SUJDMFJGYlRsVVZFdDRUa2c0Z2dFTFVrNXNkbUpIZDJWc1dWV0NBUXRGVGtOTU5WbHJOMjlMZDRJQkMwcFhRVWgzTTJacGNsVXdnZ0VMTldGbFVGQXpiRFZoU0VXQ0FRdEJSbEZ1TUVwc1NVSmlhNElCQ3pCaFlVVTFWMmR2V1VaWmdn",
"country": "US",
"estimated_results": 22144,
"lang": "en",
"number_of_videos": 20,
"query": "AL Brooks price action"
},
"docs": "https://api.tikhub.io/#/YouTube-Web-API/search_video_api_v1_youtube_web_search_video_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

