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.

