GET
/
files
/
thumbnails
/
{videoId}
curl --request GET \
  --url https://api.poix.io/files/thumbnails/{videoId} \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "default",
    "width": 120,
    "height": 90,
    "format": "webp",
    "ratio": "4:3",
    "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/default.webp"
  },
  {
    "id": "medium",
    "width": 320,
    "height": 180,
    "format": "webp",
    "ratio": "16:9",
    "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/mqdefault.webp"
  },
  {
    "id": "high",
    "width": 480,
    "height": 360,
    "format": "webp",
    "ratio": "4:3",
    "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/hqdefault.webp"
  },
  {
    "id": "standard",
    "width": 640,
    "height": 480,
    "format": "webp",
    "ratio": "4:3",
    "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/sddefault.webp"
  },
  {
    "id": "maxres",
    "width": 1280,
    "height": 720,
    "format": "webp",
    "ratio": "16:9",
    "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp"
  },
  {
    "id": "default",
    "width": 120,
    "height": 90,
    "format": "jpg",
    "ratio": "4:3",
    "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg"
  },
  {
    "id": "medium",
    "width": 320,
    "height": 180,
    "format": "jpg",
    "ratio": "16:9",
    "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg"
  },
  {
    "id": "high",
    "width": 480,
    "height": 360,
    "format": "jpg",
    "ratio": "4:3",
    "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
  },
  {
    "id": "standard",
    "width": 640,
    "height": 480,
    "format": "jpg",
    "ratio": "4:3",
    "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg"
  },
  {
    "id": "maxres",
    "width": 1280,
    "height": 720,
    "format": "jpg",
    "ratio": "16:9",
    "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  }
]

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
videoId
string
required

The YouTube video ID

Required string length: 11
Example:

"dQw4w9WgXcQ"

Response

200
application/json
Successful response
​
url
string
required

The URL of the thumbnail image

​
width
integer
required

The width of the thumbnail image

Required range: x > 0
​
height
integer
required

The height of the thumbnail image

Required range: x > 0