Returns all thumbnails for a video — start/cover (custom + auto-generated candidates), pause, and end. Filenames are relative to the CDN; prefix accordingly to render.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /thumbs/{video_id}
{video_id}Returns the list of thumbnails for a video — including the currently active custom thumbnail (if any) and the auto-generated options that you can pick from. Also exposes pause and end thumbnails configured for the video.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /thumbs/{video_id}
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
video_id | string (uuid) | Yes | ID of the video. | uuid |
Response
Success Response (200)
Returns the thumbnails object wrapped in response:
{
"response": {
"thumbnail": "thumbnail.jpg",
"default": ["thumbnail.jpg", "alt-1.jpg", "alt-2.jpg"],
"generatedThumbs": ["alt-1.jpg", "alt-2.jpg", "alt-3.jpg"],
"currentThumb": "thumbnail.jpg",
"pauseThumbnail": ["pause-abc123.jpg"],
"endThumbnail": "end-xyz789.jpg"
}
}Response Schema
| Field | Type | Description |
|---|---|---|
response | object | Wrapper containing the thumbnail fields. |
response.thumbnail | string | undefined | Filename of the currently active start/cover thumbnail (custom or default). |
response.default | array of strings | Auto-generated start thumbnail candidates returned by the legacy API. |
response.generatedThumbs | array of strings | Auto-generated thumbnail filenames the user can pick from. |
response.currentThumb | string | undefined | Active thumbnail filename (may match thumbnail or a generated one). |
response.pauseThumbnail | array of strings | Pause thumbnails currently configured for the video. |
response.endThumbnail | string | undefined | End thumbnail filename, if configured. |
Building the CDN URLFilenames returned here are paths/names — not full URLs. To render them, prefix with the appropriate CDN host (
cdn.pandavideo.com/vz-<pullzone>/<videoExternalId>/...for start;thumbs.tv.pandavideo.com.br/...for pause/end). The dashboard does this rewrite infeatures/thumbnails/thumbnails.api.ts#getCdnThumbUrl.
Error Responses
- 401 Unauthorized — Missing or invalid API token.
- 404 Not Found — Video not found.
- 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X GET \
'https://api-v2.pandavideo.com.br/thumbs/<video_id>' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'