YouTube Get Shorts Search

2.07 credits/call
ae_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.

VideoSocial
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.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
sort_byunknown | nullNo排序方式 | Sort by for Shorts—
time_zonestringNo时区(如America/Los_Angeles, Asia/Shanghai等)/Time zoneAmerica/Los_Angeles
upload_timeunknown | nullNo上传时间过滤 | Upload time filter for Shorts—
country_codestringNo国家代码(如US, CN等)/Country codeUS
search_querystringYes搜索关键字/Search keyword—
language_codestringNo语言代码(如zh-CN, en-US等)/Language codeen-US
continuation_tokenstring | nullNo翻页令牌/Pagination token—
filter_mixed_contentbooleanNo是否过滤混合内容(长视频),默认True / Filter mixed content (long videos), default Truetrue

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.