Skip to main content

Query Parameters

string
A YouTube @handle or custom URL slug to resolve (e.g. @YouTube, youtube). Provide either handle or url.
string
Any YouTube URL to resolve (channel, video, or playlist). Provide either handle or url.

Response

string
The handle or URL that was resolved.
string
Resolved entity type: channel, video, or playlist (nullable).
string
Canonical channel id, if applicable (nullable).
string
Channel @handle, if applicable (nullable).
string
Video id, if the input resolved to a video (nullable).
string
Playlist id, if the input resolved to a playlist (nullable).
string
The canonical URL of the resolved entity (nullable).

Example Response

A resolve request costs 2 credits. Failed requests are not charged.

Reference & Utility Endpoints

These low-cost helper endpoints share this section.

oEmbed

GET /v1/youtube/oembed?url=... returns YouTube’s public oEmbed metadata for a video or playlist URL — title, author_name, author_url, thumbnail_url, html embed snippet, and dimensions. Costs 1 credit.

Categories

GET /v1/youtube/categories?gl=US returns the video category reference list for a region. Each row has id and title. Free (0 credits).

Languages

GET /v1/youtube/languages returns the supported UI languages (valid hl values), each with id (code) and title. Free (0 credits).

Regions

GET /v1/youtube/regions returns the supported content regions (valid gl values), each with id (code) and title. Free (0 credits).

Markets

GET /v1/youtube/markets returns the supported markets reference (region + language pairings). Free (0 credits).
oEmbed costs 1 credit; categories, languages, regions, and markets are free reference endpoints (0 credits). Failed requests are not charged.