Announcing our brand new Developer Guides and API documentation in beta! Click here to see the new docs.

Using the JW Platform Delivery API for Embedding on Your Site

The JW Platform Delivery API at cdn.jwplayer.com offers endpoints from which you can request content and players configured in JW Platform. Embedding JW Platform hosted content and players in your sites and applications is achieved with the Delivery API through a standard URL scheme giving access to pre-packaged single line embeds, feeds, sources and other assets. These endpoints are the correct mechanism for making high volume calls from your webpage or application and are optimized for quick responses. Requests to the content service can be protected with URL token signing.

We are in the process of building out a second version of the Delivery API. The fundamental changes in the v2 endpoints are:

  • Interactive API documentation flowing from an Open API Initiative compliant API definition.
  • Consistent naming across v2 Management and Delivery APIs aligned with terminology in the dashboard and support documentation.
  • Significantly more request time parameterization, v2 endpoints accept numerous query parameters allowing for future feature growth without complicating simple calls.
  • URL token signing based on modern cryptography and the JSON Web Tokens (JWT) standard.

Delivery API v2 endpoints:

  • /v2/media/ provides a json object or rss feed describing a media item including metadata, sources, and associated assets like tracks.
  • /v2/playlists/ provides a json object or rss feed describing a playlist item including metadata and constituent media items with their metadata, sources, and associated assets like tracks.

Delivery API v1 endpoints:

  • /feeds/ deprecated in favor of /v2/media/{media_id} and /v2/playlists/{playlist_id}
  • /libraries/ provides access to single line embeddable cloud-hosted players with no media. This will be migrated to /v2/players/{player_id}
  • /players/ provides access to single line embeddable cloud-hosted players with media included in the embed. /v2/media-players/{media_id}-{player_id} and /v2/playlist-players/{playlist_id}-{player_id}
  • /videos/ provides access to individual video transcodes hosted with JW Platform. This will be migrated to /v2/media/{media_id}/sources/{source}
  • /manifests/ provides access to adaptive bitrate streaming manifests for videos hosted with JW Platform. This will be migrated to /v2/media/{media_id}/sources/{source}
  • /thumbs/ provides access to video poster images. This will be migrated to /v2/media/{media_id}/images/{size}
  • /tracks/ provides access to video timed text track files. This will be migrated to /v2/media/{media_id}/tracks/{track_id}