Content Object

Note

Fields marked with asterisk (*) are optional.

Parameter

Type

Description

id

string

ID uniquely identifying the content.

episode*

integer

Episode number.

title*

string

Content title e.g., Lost Kingdom - SE02 EP03.

season*

string

Content season e.g., “Season 3”.

artist*

string

Artist credited with the content.

genre*

string

Genre that best describes the content. You may need to discuss with your trading partners about aligning around a particular taxonomy. There’s a few taxonomies for defining the genre, the IAB Content taxonomy being the most standard one at the moment.

album*

string

Album to which the content belongs; typically for audio.

isrc*

string

International Standard Recording Code conforming to ISO-3901.

url*

string

A single URL of the content, for buy-side contextualization or review.

cat*

array of strings

Array of content categories using IDs from the IAB taxonomy.

prodq*

integer

Production quality: 1 Professionally Produced, 2 Prosumer 3 User Generated (UGC).

context*

integer

Type of content:1 Video. 2 Game. 3 Music. 4 Application. 5 Text. 6 Other. 7 Unknown

rating*

string

Content rating (e.g., MPAA).

userrating*

string

User rating of the content (e.g., number of stars, likes, etc.).

keywords*

string

Comma separated list of keywords describing the content.

livestream*

integer

Indication of live content, where 0 = not live, 1 = live (e.g., stream, live blog).

sourcerelationship*

integer

Source relationship, where 0 = indirect, 1 = direct.

len*

integer

Length of content in seconds; typically for video or audio.

lang*

string

Comma separated list of keywords describing the content.

embed*

integer

Indicator of whether or not the content is embedded off-site from the the site or app described in those objects (e.g., an embedded video player), where 0 = no, 1 = yes.

producer*

object

Details about the content producer. Refer to Object: Producer.

data*

array of objects

Additional user data. Each Data object represents a different data source, see the Data Object.

network*

object

Details about the network the content is on, see the Network Object section for more details.

channel*

object

Details about the channel the content is on, , see the Channel Object section for more details.

Content Object Example

{
  "content":{
    "cat":[
      "IAB-1",
      "IAB-2"
    ],
    "rating":"MPAA",
    "context":1,
    "episode":1,
    "genre":"comedy",
    "id":"472759950",
    "lang":"en",
    "len":15,
    "livestream":1,
    "prodq":1,
    "season":"Season 3",
    "title":"Law & Order Criminal Intent S03 - Ep18 Ill-Bred HD Watch",
    "url":"https://forums.watchuseek.com/showthread.php"
  }
}