Skip to main content
POST
YouTube Trending Shorts API

YouTube Trending Shorts

Pull the Shorts YouTube is currently surfacing as trending, each with its title, channel, views, likes, comments, length and publish time. Every run takes a fresh sample from the trending pool, so a scheduled job builds a wider picture of what is taking off over the day.
Every field is optional. results_limit sets how many Shorts to return (default 48, up to 200). Each run samples what is trending at that moment, so two runs a few minutes apart share only a handful of Shorts.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Every field is optional. Returns Shorts trending on YouTube right now; each run draws a fresh set. results_limit defaults to 48 and accepts 1 to 200.

callback_url
string<uri>
results_limit
integer
default:48
Required range: 1 <= x <= 200

Response

Task accepted

code
integer
data
object