YouTube Search Videos

2.07 credits/call
ae_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"}`

VideoSocial
2.07 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
order_bystringNo排序方式/Order bythis_month
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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.