Single media, playback metadata endpoint

get

https://cdn.jwplayer.com/v2/sites/{site_id}/media/{media_id}/playback.json

Returns all metadata and assets necessary for media playback in a JWX player, such as images, tracks, conversions, and manifests.

This endpoint serves both non-DRM and DRM-protected content. For DRM-protected content, the request must include both a JWT and the drm_policy_id parameter.

See Playlists for more information on how to use this route for playback in a JWX player.

Response format is JSON only.

For media with a renditions hosting type (CMAF VOD), the thumbnails track is served at /v2/sites/{site_id}/media/{media_id}/thumbstrip.vtt rather than the /strips/{media_id}-120.vtt shown in the examples below.

Path Params

site_id

string

required

Property or site ID that owns a piece of media

media_id

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

recommendations_playlist_id

string

Eight-character, alphanumeric ID (ex: wZuMVmMk) that uniquely identifies the recommendations playlist to use

If no recommendations_playlist_id is included, the playlist will use the default recommendations 'similar video' playlist for the property.

token

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.

drm_policy_id

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.

ad_config_id

string

Unique identifier of the ad config

Headers

string

enum

Defaults to application/json; charset=utf-8

Generated from available response content types

Allowed:

Responses

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.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json; charset=utf-8

playlist