Shorts search (raw data, recommend V2)
https://api.sandbase.ai/v1/api/youtube/web-v2/shorts-searchYouTube Shorts specialized search using native YouTube API.
- Price
- $0.0015USD / callFirst 100 calls per day free (shared per organization)
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 7 optional
Production route
Try the model
Playground
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
OutputExample
[
{
"data": {
"contents": {
"twoColumnSearchResultsRenderer": {
"primaryContents": {
"sectionListRenderer": {
"contents": [
{
"itemSectionRenderer": {
"contents": [
{
"gridShelfViewModel": {
"contentAspectRatio": "GRID_SHELF_CONTENT_ASPECT_RATIO_TWO_BY_THREE",
"contents": [
{
"shortsLockupViewModel": {
"accessibilityText": "Python高级程序员是怎么练成的？ #python编程 #python #vscode #初级程序员#高级程序员, 1.4 thousand views - play Short",
"entityId": "shorts-shelf-item-fsCtzTdOCE4",
"indexInCollection": 0,
"inlinePlayerData": {
"enableAudioControl": true,
"maxPlaybackLengthSec": 0,
"onVisible": {
"innertubeCommand": {
"clickTrackingParams": "COcCEIf2BBgAIhMI2NWgov-TlwMVYd0WCR0nzweDMgZzZWFyY2hSDFB5dGhvbue8lueoi5oBBQgyEPQkygEEppeMeA==",
"commandMetadata": {
"webCommandMetadata": {
"rootVe": 3832,
"url": "/watch?v=fsCtzTdOCE4&pp=YAHIAQHwAQG6AwIYAqIGFQFOuZ0UpZySCfP-3Z1i79LOpYn3OpAHAg%3D%3D",
"webPageType": "WEB_PAGE_TYPE_WATCH"
}
},
"watchEndpoint": {
"playerExtraUrlParams": [
{
"key": "inline",
"value": "1"
}
],
"playerParams": "YAHIAQHwAQG6AwIYAqIGFQFOuZ0UpZySCfP-3Z1i79LOpYn3OpAHAg%3D%3D",
"videoId": "fsCtzTdOCE4",
"watchEndpointSupportedOnesieConfig": {
"html5PlaybackOnesieConfig": {
"commonConfig": {
"url": "https://rr2---sn-2onajj-55.googlevideo.com/initplayback?source=youtube&oeis=1&c=WEB&oad=3200&ovd=3200&oaad=11000&oavd=11000&ocs=700&oewis=1&oputc=1&msp=1&odepv=1&id=7ec0adcd374e084e&ip=153.66.31.10&initcwndbps=3176000&mt=1790691685&oweuc="
}
}
}
}
}
}
},
"inlinePopStateEntityKey": "Eh1zaG9ydHMtc2hlbGYtaXRlbS1mc0N0elRkT0NFNCDMAygB0.663679",
"loggingDirectives": {
"gestures": {
"types": "2"
},
"trackingParams": "COcCEIf2BBgAIhMI2NWgov-TlwMVYd0WCR0nzweD",
"useGreenPath": true,
"visibility": {
"types": "12"
}
},
"menuOnTap": {
"innertubeCommand": {
"clickTrackingParams": "COcCEIf2BBgAIhMI2NWgov-TlwMVYd0WCR0nzweDygEEppeMeA==",
"showSheetCommand": {
"panelLoadingStrategy": {
"inlineContent": {
"sheetViewModel": {
"content": {
"listViewModel": {
"listItems": [
{
"listItemViewModel": {
"leadingImage": {
"sources": [
{
"clientResource": {
"imageName": "ADD_TO_QUEUE_TAIL"
}
}
]
},
"rendererContext": {
"commandContext": {
"onTap": {
"innertubeCommand": {
"clickTrackingParams": "COgCEP6YBBgCIhMI2NWgov-TlwMVYd0WCR0nzweDygEEppeMeA==",
"commandMetadata": {
"webCommandMetadata": {
"sendPost": true
}
},
"signalServiceEndpoint": {
"actions": [
{
"addToPlaylistCommand": {
"listType": "PLAYLIST_EDIT_LIST_TYPE_QUEUE",
"onCreateListCommand": {
"clickTrackingParams": "COgCEP6YBBgCIhMI2NWgov-TlwMVYd0WCR0nzweDygEEppeMeA==",
"commandMetadata": {
"webCommandMetadata": {
"apiUrl": "/youtubei/v1/playlist/create",
"sendPost": true
}
},
"createPlaylistServiceEndpoint": {
"params": "CAQ%3D",
"videoIds": [
"fsCtzTdOCE4"
]
}
},
"openMiniplayer": true,
"videoCommand": {
"clickTrackingParams": "COgCEP6YBBgCIhMI2NWgov-TlwMVYd0WCR0nzweDygEEppeMeA==",
"commandMetadata": {
"webCommandMetadata": {
"rootVe": 3832,
"url": "/watch?v=fsCtzTdOCE4",
"webPageType": "WEB_PAGE_TYPE_WATCH"
}
},
"watchEndpoint": {
"videoId": "fsCtzTdOCE4",
"watchEndpointSupportedOnesieConfig": {
"html5PlaybackOnesieConfig": {
"commonConfig": {
"url": "https://rr2---sn-2onajj-55.googlevideo.com/initplayback?source=youtube&oeis=1&c=WEB&oad=3200&ovd=3200&oaad=11000&oavd=11000&ocs=700&oewis=1&oputc=1&msp=1&odepv=1&id=7ec0adcd374e084e&ip=153.66.31.10&initcwndbps=3176000&mt=1790691685&oweuc="
}
}
}
}
},
"videoId": "fsCtzTdOCE4",
"videoIds": [
"fsCtzTdOCE4"
]
},
"clickTrackingParams": "COgCEP6YBBgCIhMI2NWgov-TlwMVYd0WCR0nzweDygEEppeMeA=="
}
],
"signal": "CLIENT_SIGNAL"
}
}
}
},
"loggingContext": {
"loggingDirectives": {
"trackingParams": "COgCEP6YBBgCIhMI2NWgov-TlwMVYd0WCR0nzweD",
"visibility": {
"types": "12"
}
}
}
},
"title": {
"content": "Add to queue"
}
}
},
{
"listItemViewModel": {
"leadingImage": {
"sources": [
{
"clientResource": {
"imageName": "FEEDBACK"
}
}
]
},
"rendererContext": {
"commandContext": {
"onTap": {
"innertubeCommand": {
"clickTrackingParams": "COcCEIf2BBgAIhMI2NWgov-TlwMVYd0WCR0nzweDygEEppeMeA==",
"commandMetadata": {
"webCommandMetadata": {
"ignoreNavigation": true
}
},
"userFeedbackEndpoint": {
"additionalDatas": [
{
"userFeedbackEndpointProductSpecificValueData": {
"key": "video_id",
"value": "fsCtzTdOCE4"
}
},
{
"userFeedbackEndpointProductSpecificValueData": {
"key": "lockup",
"value": "shelf"
}
}
]
}
}
}
}
},
"title": {
"content": "Send feedback"
}
}
}
]
}
}
}
}
}
}
}
},
"menuOnTapA11yLabel": "More actions",
"onTap": {
"innertubeCommand": {
"clickTrackingParams": "COcCEIf2BBgAIhMI2NWgov-TlwMVYd0WCR0nzweDUgxQeXRob27nvJbnqIuaAQUIMhD0JMoBBKaXjHg=",
"commandMetadata": {
"webCommandMetadata": {
"rootVe": 37414,
"url": "/shorts/fsCtzTdOCE4",
"webPageType": "WEB_PAGE_TYPE_SHORTS"
}
},
"reelWatchEndpoint": {
"loggingContext": {
"qoeLoggingContext": {
"serializedContextData": "CgIIDA%3D%3D"
},
"vssLoggingContext": {
"serializedContextData": "CgIIDA%3D%3D"
}
},
"overlay": {
"reelPlayerOverlayRenderer": {
"reelPlayerNavigationModel": "REEL_PLAYER_NAVIGATION_MODEL_UNSPECIFIED",
"style": "REEL_PLAYER_OVERLAY_STYLE_SHORTS",
"trackingParams": "COkCELC1BCITCNjVoKL_k5cDFWHdFgkdJ88Hgw=="
}
},
"params": "CBQwAkoeCg4iDFB5dGhvbue8lueoixIMUHl0aG9u57yW56iLugEYVUNhQUJLVmY5c1lHZDFqR01YRlhPX1Jn",
"playerParams": "8AEBoAMIyAMyuAQUogYVAU65nRS4l8YL6xkE9cZp0AnfX2VSkAcC",
"sequenceParams": "Cgtmc0N0elRkT0NFNCqeAQoNCgtaZ1M0ZS0tNG5GWQoNCgtGX1B6WVB0ZnZFWQoNCgt2aXBSNDVHdGVCRQoNCgtZZnZ4TEpnRmM4WQoNCgs3akJSU3NQY3pSZwoNCgt5RHVtejQwVk5jawoNCgtPV2tTeGIxdzU2RQoNCgt3VVh1V0E1TUpvNBAAGBQiHgoOIgxQeXRob27nvJbnqIsSDFB5dGhvbue8lueoizABcAGAAQGqAQYIAhoCGADaAegLCgxQeXRob27nvJbnqIsSBWVuLVVTGo0ECoAEAADcvAAAkb0AADY9AAC-uwAAoL0AAEW9AADKvAAAdz0AAEC9AACfPQAANTwAAPE9AADCOwAAEz4AAGS8AADIPQAAKj0AADW8AACgOwAAGz4AAC68AABaPAAAuL0AANY8AAAaPgAAGb0AACO8AACrPQAA0LwAADK9AAA9vgAA6rwAAK-9AAC5vQAAP74AAKy9AADLPAAA_jwAAAs9AAChPAAAhL0AABm9AABCPgAARr0AAGe8AACKPQAA8z0AALy9AABKPQAALT4AAJU9AADPPAAAJL4AAC68AACGvQAATz0AAG-9AADUPAAAwD0AAIq8AADDvAAACb4AADO9AACbvQAAkzwAACE8AAByvQAAu7wAABc-AADWOwAA1T0AAAA8AAAdPQAAVL4AACe9AAAdPQAAhb0AADq9AACMOwAAK70AAHO8AACZPQAAZTwAALo8AAARvQAADzsAAMK9AAANPgAAOD0AAEs8AAAIvgAATD0AALK9AAAQvQAAPbsAAAS-AACgvQAAF74AACY-AADdvgAA0DwAANQ9AADiPQAAcr0AAIU8AAArPgAAgL0AAEY-AAAXvQAA-zwAAE49AABEvgAAVj0AALc8AACzPAAAQz0AADE9AAAFPQAAfD0AAJq8AAA8PQAAsDwAAFS9AAAHPQAAMDkAALu9AAD0uwAANr0YNyACQgQIABABIg0KC3gtOXF3LUtfZDdnIg0KCzRyc0pDNmEzSHZZIg0KC25zVFBFTGx0Rlh3Ig0KC0R2OHJjYmVfdEE0Ig0KC0piZTEwYndqRmZvIg0KCzVRMlg0Mldpbk5NIg0KC3ItckM4NmFydFFnIg0KCy1peW9TMnlzdnpjIg0KC1V3SEE3cHQtZkxJIg0KC1p6SjYzeW1qOE5NIg0KC3AwMGlFMzFEN1ZFIg0KC2p1a3d2YmY1WDlFIg0KC3lIWHNMRUI4aG9jIg0KC1dPa19VQmcxUkN3Ig0KC0lsdk9LRGQ2czNzIg0KC2tCTTFEN3ktaHJNIg0KC0xPSzhHRVhkOHlNIg0KC1g2Y0p6UkNuTWNZIg0KC3hTbzlCbTcwU2NRIg0KC3c3cDZfalNwMWQ4Ig0KC3FpWGhQTndndnBJIg0KC1JuWDlzekJDZWM0Ig0KC2Myci1NNFdGVTNjIg0KC3F2NGRLZDA3VWN3Ig0KC1FEZ3JXUkZYRVhFIg0KC3FMN2YxZEs2aExjIg0KC3lhYkdlVWRnMzhFIg0KC0hCRDdDZ3BQREJ3Ig0KCzlQNkdfOW5mYnZJKo0ECoAEAAArvQAAqT0AANY5AACkPQAAiD0AAEU9AAABvgAAir0AAJS9AACdPQAAir0AACQ7AAA4PgAA9D0AAOo9AADvPQAAe70AAP48AACyPQAAgj0AACI9AAANPQAAX7sAAIa9AACcPAAAJL4AAAo6AAAdvgAA8T0AAPy6AAA1vQAAGb4AAA8-AAC7PQAAID0AAE69AAC_PQAAfD0AAMe9AABnPQAAsT0AAOI9AADAPQAAoT0AAAu9AAAYPQAAsb0AAPm8AABaPQAAPz0AAKk6AAAhOgAAsL0AADE9AADtvQAAzT0AAFY9AACMPAAAtTwAAKw8AADDPQAAaD0AAAc9AABTPQAAIL4AAC69AACVOwAA370AAJq8AACbvQAArz0AAMG8AAAjvQAAmzwAAI69AACkPAAA8rwAAFG9AABTvQAAJj0AAJs8AABPPAAAH70AADA-AAC9PAAA270AAOU9AABGPQAA770AAKE9AAABvgAAjLwAAGK9AABLvQAALD4AADA9AADgPQAAaD4AABg-AAAZvQAAxbwAALy9AAC8PQAA4D0AALO7AAArvQAAkT0AABc-AAAhvQAAvL0AABC-AAAOPAAAh7wAABK9AADjvQAAx7wAABO9AADtPQAA9LsAACu6AADNvQAAxD4AACY-AACvPQAAbz0AAAc9AAC6vAAAfjwYNiACQgQIABAB",
"sequenceProvider": "REEL_WATCH_SEQUENCE_PROVIDER_RPC",
"thumbnail": {
"isOriginalAspectRatio": true,
"thumbnails": [
{
"height": 1920,
"url": "https://i.ytimg.com/vi/fsCtzTdOCE4/frame0.jpg?usqp=CCY",
"width": 1080
}
]
},
"ustreamerConfig": "CAw=",
"videoId": "fsCtzTdOCE4"
}
}
},
"overlayMetadata": {
"primaryText": {
"content": "Python高级程序员是怎么练成的？ #python编程 #python #vscode #初级程序员#高级程序员"
},
"secondaryText": {
"content": "1.4K views"
}
},
"stackedFrameData": {},
"thumbnailViewModel": {
"thumbnailViewModel": {
"image": {
"sources": [
{
"height": 720,
"url": "https://i.ytimg.com/vi/fsCtzTdOCE4/oar2.jpg?sqp=-oaymwEsCJUDENAFSFqQAgHyq4qpAxsIARUAAIhC2AEB4gEKCBgQAhgGOAFAAbgC8xg=&rs=AOn4CLDyPiRHSFIDddpylhyFEJxlgO0ZWg&usqp=CCk",
"width": 405
},
{
"height": 608,
"url": "https://i.ytimg.com/vi/fsCtzTdOCE4/oar2.jpg?sqp=-oaymwEvCJUDEOAESFqQAgHyq4qpAx4IARUAAIhCyAEB2AEB4gEKCBgQAhgGOAFAAbgC8xg=&rs=AOn4CLBUWa-16loOLOCo32D9jZJMb6z_MQ&usqp=CCk",
"width": 405
}
]
}
}
},
"titleTruncationStyle": "SHORTS_LOCKUP_TITLE_TRUNCATION_STYLE_UNKNOWN"
}
},
{
"shortsLockupViewModel": {
"accessibilityText": "Python安裝教程（2025最新版）|從零開始配寘Python環境|手把手教你安裝Python環境|包含環境變數設定教程 #prompt #python自動化, 2.4 thousand views - play Short",
"entityId": "shorts-shelf-item-ZgS4e--4nFY",
"indexInCollection": 0,
"inlinePlayerData": {Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.0015 / run
- Daily free calls
- First 100 calls per day free (shared per organization)
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- search_query
- string · required
- continuation_token
- any · optional
- country_code
- string · optional
- filter_mixed_content
- boolean · optional
- language_code
- string · optional
- sort_by
- any · optional
- time_zone
- string · optional
- upload_time
- any · optional
Access
- Provider
- YouTube
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/youtube/web-v2/shorts-search
- Authentication
- Bearer API key
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.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/shorts-search" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"sort_by": "rating",
"time_zone": "America/Los_Angeles",
"upload_time": "hour",
"country_code": "US",
"search_query": "Python编程",
"language_code": "en-US",
"filter_mixed_content": true
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
YouTube | $0.0015 per call | JSON | Jul 31, 2026 |
YouTube | $0.0015 per call | JSON | Jul 31, 2026 |
YouTube | $0.0015 per call | JSON | Jul 31, 2026 |
YouTube | $0.0015 per call | JSON | Jul 31, 2026 |
YouTube | $0.0015 per call | JSON | Jul 31, 2026 |
YouTube | $0.0015 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the Shorts search (raw data, recommend V2) API?
Send a POST request to https://api.sandbase.ai/v1/api/youtube/web-v2/shorts-search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the Shorts search (raw data, recommend V2) API cost?
$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
What parameters does the Shorts search (raw data, recommend V2) API accept?
Required: search_query (string). Optional: continuation_token (any), country_code (string), filter_mixed_content (boolean), language_code (string), sort_by (any) and time_zone (string) and 1 more. The Parameters table and the Playground on this page list every field.
What does the Shorts search (raw data, recommend V2) API return?
A JSON response returned in the same HTTP request (synchronous).
Do I need a YouTube developer account or API key?
No. Shorts search (raw data, recommend V2) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for YouTube API access separately.