Query Parameters
A YouTube
@handle or custom URL slug to resolve (e.g. @YouTube, youtube). Provide either handle or url.Response
Example Response
A resolve request costs 3 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 2 credits.
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 2 credits; categories, languages, regions, and markets are free reference endpoints (0 credits). Failed requests are not charged.

