Content Object

Note

Fields marked with asterisk (*) are optional.

Content Object Properties

Value

Type

Description

id*

string

ID uniquely identifying the content.

episode*

integer

Episode number.

title*

string

Content title e.g., "The Shrimp Incident"

series*

string

The content series, e.g. "Curb Your Enthusiasm"

season*

string

Content season e.g., "Season 2"

artist*

string

Artist credited with the content

genre*

string

Genre that best describes the content, e.g., rock, pop, etc. 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.

producer*

object

Details about the content producer, see Producer Object

url*

string

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

cattax*

int

The taxonomy in use for cat. If no cattax field is supplied, the IAB Content Category Taxonomy 1.0 (1) is assumed. For the most up to date list, refer to the AdCOM 1.0 list List.

  • 1 IAB Tech Lab Content Category Taxonomy 1.0

  • 2 IAB Tech Lab Content Category Taxonomy 2.0

  • 3 IAB Tech Lab Ad Product Taxonomy 1.0

  • 4 IAB Tech Lab Audience Taxonomy 1.1

  • 5 IAB Tech Lab Content Taxonomy 2.1

  • 6 IAB Tech Lab Content Taxonomy 2.2

  • 500+ Vendor-specific codes

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 (i.e., video file or stream such as Internet TV broadcasts)

  • 2 Game (i.e., an interactive software game)

  • 3 Music (i.e., audio file or stream such as Internet radio broadcasts)

  • 4 Application (i.e., an interactive software application)

  • 5 Text (i.e., primarily textual document such as a web page, eBook, or news article)

  • 6 Other (i.e., none of the other categories applies)

  • 7 Unknown

contentrating*

string

Content rating (e.g., MPAA).

userrating*

string

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

qagmediarating*

integer

Media rating per IQG guidelines. Refers to the following list:

  • 1 All Audiences

  • 2 Everyone Over Age 12

  • 3 Mature Audiences

  • Note: this may also be passed as mrating

keywords*

string

Comma separated list of keywords describing the content.

kwarray*

array of string

An array of keywords about the content, e.g ["news", "weather", "sports"]. Only one of keywords or kwarray should be passed.

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.

language*

string

Content language using ISO-639-1-alpha-2.

langb*

string

Content language using IETF BCP 47. Only one of language or langb should be present.

embeddable*

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.

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",
    "language":"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",
    "userrating":"4.1",
    "network":{
      "id":"WTV",
      "name":"World TV",
      "domain":"example.com"
    },
    "channel":{
      "id":"WTV7",
      "name":"Channel 7 Sports",
      "domain":"example.com/sports"
    }
  }
 }