Create a new playlist

There are several types of playlists: manual, dynamic, trending, feed, search, and article matching. The type is selected upon creation and cannot be changed afterwards. Note: channels and playlists are synonymous.

Query Params
string
enum
required

(Required) Type of playlist

Possible values include:

  • article_matching: Insert contextually relevant videos into your articles. Filtering rules apply, including tag rules (inclusion and exclusion) and recency filtering. Article Matching playlists are limited to a maximum of 100 videos. Also read about how to Embed videos with Article Matching.

  • dynamic: Automatically sort your videos using channels/update API call to specify what to sort by (publish date for example). Dynamic playlists are limited to a maximum of 500 videos.

  • feed: Feed playlists return a set of recommended videos based on a source video. Feed channels are known as 'Recommendation Playlists' in the JWX dashboard. Set the rules by which the playlist is filtered by using the /channels/update API call. Recommendations playlists are limited to a maximum of 100 videos. This type of playlist requires an account upgrade.

  • manual: Manual channels are ordered by the user manually. Manage the playlist's content using /channel/videos/create and /channels/video/update API calls. Manual playlists are limited to a maximum of 500 videos.

  • search: Search playlists contain videos ordered by similarity to a search term or phrase. Set the rules by which the playlist is filtered by using /channels/update API call. Search playlists are limited to a maximum of 100 videos. This type of playlist requires an account upgrade.

  • trending: Trending channels contain videos ordered by how much the videos are trending in the last few hours. Set the rules by which the playlist is filtered by using channels/update API call. Trending playlists are limited to a maximum of 500 videos. This type of playlist requires an account upgrade.

Allowed:
string

Author of the playlist

string

Key-value pairs that are included in the playlist delivery

When creating these key-value pairs, be sure to adhere to the following guidance:

  • Key ({param}) can contain letters, numbers, and the punctuation characters: ., _ , -
  • Key cannot start with a number or punctuation character
  • Key cannot contain spaces
  • Do not use reserved names for custom parameters, reserved names include: feedid, kind, playlist
  • Do not use any existing non-custom parameter names, for example: title, description, author, etc.

Valid custom playlist parameters can be specified multiple times.

WARNING: Custom parameters that use a reserved name or an existing name are not guaranteed to be included in the output from the Delivery API.

string

Description of the playlist

string

Title of the playlist

Headers
string
enum
Defaults to application/xml

Generated from available response content types

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Choose an example:
Response
© 2007- Longtail Ad Solutions, Inc.