youtube/web-v2/shorts-search
YouTube Shorts specialized search using native YouTube API.
Input
Pagination token
Country code affecting regional relevance
Whether to filter long videos from mixed content (default true)
Language code (zh-CN for Chinese, en-US for English)
Search keyword
Sort by for Shorts
Time zone (e.g., America/Los_Angeles, Asia/Shanghai)
Upload time filter for Shorts
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
youtube/web-v2/shorts-search01
Input Schema
8 parameters · 1 required · 7 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
search_query | string | Required | Search keyword · Max length: 200 |
sort_by | union | Optional | Sort by for Shorts |
time_zone | string | Optional | Time zone (e.g., America/Los_Angeles, Asia/Shanghai) · Default: "America/Los_Angeles" |
upload_time | union | Optional | Upload time filter for Shorts |
country_code | string | Optional | Country code affecting regional relevance · Default: "US" |
language_code | string | Optional | Language code (zh-CN for Chinese, en-US for English) · Default: "en-US" |
continuation_token | union | Optional | Pagination token |
filter_mixed_content | boolean | Optional | Whether to filter long videos from mixed content (default true) · Default: true |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "youtube/web-v2/shorts-search",
"sort_by": "rating",
"time_zone": "America/Los_Angeles",
"upload_time": "hour",
"country_code": "US",
"language_code": "en-US",
"filter_mixed_content": true,
"prompt": "a beautiful sunset over mountains"
}'API README
Shorts search (raw data, recommend V2)
YouTube Shorts specialized search using native YouTube API. It is suitable for youtube workflows.
Capability
YouTube Shorts specialized search using native YouTube API. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Search and discover relevant records for research, monitoring, and product experiences.
- Create repeatable integrations that pass structured results to downstream business systems.
- Support scheduled jobs, internal tools, and agent workflows with structured results.