Playlist objects/feeds

Eight-character, alphanumeric ID (ex: WXu7kuaW) that uniquely identifies the playlist

You can find it in the playlist details page in the dashboard OR in the Management API in /channels.

Ensures that a video result is always returned for dynamic playlists with a trending sort order, Article Matching playlists, or search playlists.

If no video results are explicitly returned for the given query, a Trending playlist is returned as the result.

For Article Matching playlists and dynamic playlist with a trending sort order, true is the default. For search playlists, false is the default.

Sets the maximum bitrate of media to be included in playlist

Media with a bitrate higher than the specified value will not be included.

Sets the minimum bitrate of media to be included in playlist

Media with a bitrate lower than the specified value will not be included.

Whether to provide a fallback if the requested source qualities do not exist

Default behavior is false.

When this parameter is true, the playlist will be populated with the next valid rendition, if one exists.

Use of this parameter is not recommended, but it is available to provide similar behavior to legacy feed generation logic.

Filter for playlists to exclude assets with certain media custom parameters

Specified as a URL-encoded, comma-separated list of name:value-formatted media custom parameter(s). Parameter values are assumed not to contain commas.

By default, only assets with all specified custom parameters are excluded. The default behavior can be overridden by exclude_media_filtering_mode.

Filtering behavior for exclude_media_filtering

Possible values:

• all: (default) Excludes assets with every custom parameter
• any: Excludes assets with at least one custom parameter

Works with all playlists (channels) except manual.

Filter for playlists to exclude assets with certain media tags

Specified as a URL-encoded, comma-separated list of media tag(s). Tags are assumed not to contain commas.

By default, only assets with all specified tags are excluded. The default behavior can be overridden by exclude_tags_mode.

Filtering behavior for exclude_tags

Possible values:

• all: (default) Excludes assets with every tag
• any: Excludes assets with at least one tag

Works with all playlists (channels) except manual.

The output template format

Possible values:

• json: (Default) Provides an easy format for integrations on your site and is natively consumed by JWX
• googledfp: Aligns with the Google MRSS feed specification for Ad Manager integration
• legacyrss: Provides backward compatibility for an older RSS format previously served by JWX
• mrss: Aligns with the Media RSS specification. Optimized for playback in the JWX web player. Recommended for use with JWX's FAST Channels partnership integration
• partner_rss: Aligns with the MRSS specifications of content syndicators, e.g. MSN and Verizon Media. This format is not optimized for playback and does not include JWX Custom Parameters
• roku_rss: Aligns with the <a href="https://developer.roku.com/docs/specs/direct-publisher-feed-specs/mrss-dp-spec.md" target="_blank">Roku's Direct Publisher MRSS specification</a>"

Specifies the maximum allowed width and height for renditions.

Only renditions with both dimensions less than or equal to the provided value are included.

Possible Values:

• 320
• 480
• 640
• 960
• 1280
• 1920

This is currently only supported for use with HLS streams.

Filter for playlists to include assets with certain media custom parameters

Specified as a URL-encoded, comma-separated list of name:value-formatted media custom parameter(s). Parameter values are assumed not to contain commas.

By default, only assets with all specified custom parameters are included. The default behavior can be overridden by media_filtering_mode.

Filtering behavior for media_filtering

Possible values:

• all: (default) Includes assets with every custom parameter
• any: Includes assets with at least one custom parameter

Works with all playlists (channels) except manual.

The maximum number of items per page

For Similar Video, Search, and Article Matching playlists, the maximum value is 100. For Manual and Dynamic playlists, the maximum value is 500.

This overrides dashboard or management API settings when included with a request.

The number of items to offset for paginated requests

Values can be from 1 to N where N is the last possible item of a given playlist.

The width of poster images to include with the playlist

By default, the playlist will include 720-pixel-wide images which is a good balance between quality and page speed for most playlist thumbnail applications.

Possible values:

• 40
• 120
• 320
• 480
• 720
• 1280
• 1920

Filter for playlists based on the number of days or years passed since the publish date of a given media asset

Use the format of _D or _YR.

Examples:

• 9D will only serve media assets published less than 9 days ago
• 2YR will only serve media assets published less than 2 years ago.

When appended to an API request, this query parameter only applies when the playlist recency value is left unpopulated.

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.

(Required for Similar Video playlists) Eight-character, alphanumeric ID for the media asset JW Recommendations uses to create a similar video playlist

Recommendations are based on the related_media_id, viewer engagement and network data.

(Required for Search and Article Matching playlists) URL-encoded search phrase of one or more words separated by spaces, phrases contained by double quotes, or both.

JWX searches indexed media metadata (such as titles and descriptions) and returns the most relevant results. Please note the following about JWX's search behavior:

• By default, Article Matching playlists also search tags.
• Search playlists do not search tags unless "use_tags": true is set.
• By default, custom parameter values are not included in searches. Set use_params to specify which custom parameters to include.
• Input text is broken into terms by whitespaces and commas. For Article Matching playlists, set the search query to __CONTEXTUAL__.

The media sources included in the playlist

This is a comma-separated list of values in the order in which they should appear in the playlist.

One can specify sources by adaptive streaming formats (dash, hls), quality levels (ex: 1080p, 720p, 1920px), or legacy template IDs.

Note that mixing the way the sources are specified may have unexpected results.

Filter for playlists to include assets with certain media tags

Specified as a URL-encoded, comma-separated list of media tag(s). Tags are assumed not to contain commas.

By default, only assets with all specified tags are included. The default behavior can be overridden by tags_mode.

Filtering behavior for tags

Possible values:

• all: (default) Includes assets with every tag
• any: Includes assets with at least one tag

Works with all playlists (channels) except manual.

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.

(Search playlists only) Includes tags in the considered metadata.

Default: false.

(Search playlists only) Comma-separated list of custom parameter keys to add to the search metadata

For example, use_params=actor,author adds the values of the actor and author custom parameters when searching for matching media.