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"
}
}