YouTube Get Shorts Search
## Search YouTube Shorts Find Shorts matching a keyword, with optional localization, upload-time filtering, sorting, and pagination. ### Inputs - **search_query** (required): Search text, up to 200 characters. - **language_code**: Language preference, such as en-US or zh-CN; default en-US. - **country_code**: Country or region code, such as US or JP; default US. - **time_zone**: IANA time zone used for time-related filters, such as Asia/Shanghai; default America/Los_Angeles. - **upload_time**: hour, today, week, month, or year. Omit or use null for no upload-time filter. - **sort_by**: relevance, upload_date, view_count, or rating. Omit or use null for default relevance ordering. If both sorting and an upload-time filter are supplied, sorting takes precedence. - **filter_mixed_content**: Defaults to true to filter long videos from the initial results. Set false to retain the original mixed content, which may include non-Shorts videos. - **continuation_token**: Omit for the first page. To retrieve another page, use a token from the previous response and keep the keyword and other search settings unchanged. Tokens may expire; continuation requests are documented to return Shorts-only content. ### What is returned The response contains raw, nested YouTube search data with search items and a next-page token when available. It is not a cleaned, standardized video list and requires parsing. Pagination tokens fetch additional result pages, not background-task status.
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.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sort_by | unknown | null | No | 排序方式 | Sort by for Shorts | — |
time_zone | string | No | 时区(如America/Los_Angeles, Asia/Shanghai等)/Time zone | America/Los_Angeles |
upload_time | unknown | null | No | 上传时间过滤 | Upload time filter for Shorts | — |
country_code | string | No | 国家代码(如US, CN等)/Country code | US |
search_query | string | Yes | 搜索关键字/Search keyword | — |
language_code | string | No | 语言代码(如zh-CN, en-US等)/Language code | en-US |
continuation_token | string | null | No | 翻页令牌/Pagination token | — |
filter_mixed_content | boolean | No | 是否过滤混合内容(长视频),默认True / Filter mixed content (long videos), default True | true |
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_get_shorts_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"country_code": "US",
"filter_mixed_content": true,
"language_code": "en-US",
"search_query": "INMO",
"sort_by": "upload_date",
"time_zone": "Asia/Shanghai",
"upload_time": "week"
}
}'{
"detail": {
"code": 400,
"message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
"message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
"request_id": "c0af0c02-96be-4dc2-b1cc-698e4bcccad9"
}
}This example shows part of the response. Copied content is valid JSON.

