Skip to main content
POST
Download a YouTube video thumbnail

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional key for safely retrying a billable write request.

Required string length: 1 - 255

Body

application/json
url
string<uri>
required

Public YouTube video URL (watch, Shorts, live, embed, or youtu.be link).

quality
enum<string>
default:maxresdefault

Desired thumbnail resolution; lower resolutions are used automatically when the requested one is unavailable.

Available options:
maxresdefault,
sddefault,
hqdefault,
mqdefault

Response

Direct thumbnail image link and normalized public video metadata.

quality
string
required
thumbnail_url
string<uri>
required
url
string<uri>
required
video_id
string
required