Unif API Docs

Search YouTube videos by keyword

Search YouTube videos by keyword, with optional sort, upload-date, duration, region, and language filters. Returns matching videos with title, channel, and view count. Useful for topic research, competitive monitoring, and content-gap analysis.

Pricing — $ · min $0.001

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

GET
/youtube/search

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

cursor?string
q*string

Search keyword.

Length1 <= length
sort_by?string

Result ordering (default relevance).

Value in

  • "relevance"
  • "date"
  • "views"
  • "rating"
upload_date?string

Restrict to videos uploaded within this window.

Value in

  • "hour"
  • "today"
  • "week"
  • "month"
  • "year"
duration?string

Restrict by video length bucket.

Value in

  • "short"
  • "medium"
  • "long"
region?string

ISO 3166 country code, e.g. US.

Length2 <= length <= 2
language?string

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/search?q=string"
{  "request_id": "string",  "data": [    {      "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"    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}