Thumbnail track for a CMAF VOD media

Returns a WebVTT thumbnail track for scrub-bar previews.

Each cue gives the URL of an image with an #xywh= media fragment selecting a single tile from it. Cue cadence and tile size vary by media and are not fixed values.

Only applicable to media with a renditions hosting type (referred to as CMAF VOD in the dashboard). A request for a media with any other hosting type returns a 404.

A request for a CMAF VOD media with no thumbnail track also returns a 404. The response is cached only briefly, because a track can become available later.

On properties with URL signing enabled, requests must be signed. Returned media and playlist URLs are already signed. See Protect your content with signed URLs for more information.

Path Params
string
required

Property or site ID that owns a piece of media

string
required

Eight-character, alphanumeric ID that uniquely identifies the media

This can be found on the video detail page in the dashboard.

Query Params
string

Signature for requests to the Content API for protected content

It consists of a JSON Web Token (JWT) containing the parameters of the request.

When requested with no signature to prevent unauthorized access to videos, unsigned video URLs are returned.

More information is available in the developer guide.

string

Eight-character, alphanumeric ID (ex: b2Afe1zG) uniquely identifying the DRM policy to apply

If this is not included on a DRM-protected media request, the request is considered invalid. It must also be included as a parameter when generating the required JWT for DRM requests.

Responses

400

Bad Request

The request either lacks certain attributes or contains malformed/invalid attributes.

403

Access is Forbidden

This error commonly occurs when a user either does not have a token or uses an invalid token to request an asset that requires URL signing. It may also occur due to geoblocking, account suspension, deletion, or limits reached.

404

Not Found

The requested asset could not be found.

502

Bad Gateway

The request failed due to an upstream dependency error.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/vtt
© 2007- Longtail Ad Solutions, Inc.