Unif API Docs

Browse YouTube's trending videos

Return YouTube's country-aware trending videos, optionally scoped to a section (now, music, gaming, or movies). Useful for tracking what is gaining traction in a given market and timing content to live interest.

Pricing — $ · min $0.001

Billed per record at 1 credit ($0.001) each, with a 1-credit ($0.001) minimum per call.

GET
/youtube/trending

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

country?string

Optional ISO 3166 country code, e.g. US (default), GB.

Length2 <= length <= 2
type?string

Optional trending section (default now).

Value in

  • "now"
  • "music"
  • "gaming"
  • "movies"
language_code?string

Optional language code, e.g. en.

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

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/youtube/trending"
{  "request_id": "string",  "data": {    "items": [      {        "id": "string",        "title": "string",        "author": "string",        "channel_id": "string",        "description": "string",        "duration_seconds": 0,        "view_count": 0,        "published_time": "string",        "is_live": true,        "category": "string"      }    ]  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}