Shorts › Trending
Returns the Shorts trending on YouTube right now, each with view count, like count, channel info, and thumbnail.
Use it for a snapshot of what is trending in Shorts; videos/trending covers regular videos and can be narrowed by country.
Metered: 100–300 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.
Re-running the exact same call within 1h is free.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Set to channel (one token only) to add each row's channel stats in this one call. channel puts the channel's subscriber count on post.ext.author_followers (YouTube's own figure, which it rounds to three significant figures above 1,000) and fills the channel's post.author.display_name, .avatar_url and .username where missing. Each join adds 0.2 to 0.7 seconds on a fresh page (one lookup per 50 ids, never more than 8 seconds). Read data.hydration for the rows, lookups, credits held and kept, and the time.
Value in
- "channel"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/youtube/shorts/trending"{ "success": true, "platform": "instagram", "endpoint": "/v1/instagram/profile/posts", "data": { "items": [ "…" ], "dropped": 0 }, "pagination": { "next_cursor": "is2.eyJwIjoyfQ", "has_more": true, "page_size": 12 }, "credits_used": 20, "credits_remaining": 9980, "request_id": "req_1a2b3c4d5e6f", "cached": false, "idempotent_replay": false, "charge_reason": "miss", "free_call": false}Search GET
Returns YouTube search results for a keyword: videos, channels, playlists, shorts, and live streams, each with title, thumbnail, views, and channel. Use it for a general keyword search across every content kind; search/advanced returns videos only but adds date, license, and country filters. **Metered: 20–380 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 1h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).
Video › Audio GET
Returns the downloadable audio streams for a video, each with a direct media URL, mime type, bitrate, audio quality, sample rate, channels, and duration. Use it to grab a video's audio on its own; the URLs are time-limited, so fetch them straight away rather than storing them. **100 credits** per call. Re-running the exact same call within 6h is free.