Program Metadata

Although program types can vary (seasonal episodes, specials, movies, football games), some common pieces of information are available for all program types. Additional fields may be returned for particular program types. See below for descriptions of common data and specialty fields.

Common Program Data

*1 - Keywords & Recommendation retirement (April 2021)

As communicated per customer notifications, Gracenote is planning to retire the Keywords and Recommendations datasets. Timeline

• April 2021: Gracenote to stop assigning keywords and editorial recommendations to new Programs
• July 2021: Gracenote to discontinue delivery of On Keywords and Editorial Recommendations
  

Series/Episode Program Metadata

Movie Program Metadata

Sports Event Program Metadata

Example 1 - Episode Program Record

{
  "tmsId": "EP015314270020",
  "rootId": "9362638",
  "seriesId": "9085357",
  "title": "The Countdown",
  "titleLang": "en",
  "shortdescription": "A countdown of the best Clint Eastwood films shows the actor as: a gunslinger, a disc jockey.",
  "longDescription": "A countdown of the best Clint Eastwood films shows the actor as: an Old West gunslinger, a boxing coach, a war vet, a prison escapee, and a disc jockey.",
  "descriptionLang": "en",
  "subType": "Series",
  "genres": ["Entertainment"],
  "origAirDate": "2012-08-09",
  "preferredImage": {
    "uri": "tvbanners/v5/AllPhotos/9085357/p9085357_b_v5_aa.jpg",
    "height": "360",
    "width": "240",
    "primary": "true",
    "category": "Banner"
  },
  "episodeTitle": "Clint Eastwood",
  "seasonNum": 1,
  "episodeNum": 20,
  "entityType": "Episode"
}

Example 2 - Movie Program Record

{
  "tmsId": "MV003331980000",
  "rootId": "8288118",
  "title": "Battle: Los Angeles",
  "titleLang": "en",
  "shortDescription": "A Marine officer (Aaron Eckhart) and his platoon make a daring stand against alien invaders.",
  "longDescription": "For many years, humans have reported various UFO sightings around the world, fueling speculation about the existence of life on other worlds. In 2011, mankind learns the truth the hard way when alien invaders attack. One by one, the world's great cities fall, leaving Los Angeles as the battleground for humanity's last stand. It's up to a Marine staff sergeant (Aaron Eckhart) and his platoon to draw a line in the sand against a powerful enemy unlike any previously encountered.",
  "descriptionLang": "en",
  "subType": "Feature Film",
  "ratings": [
  {
    "body": "Alberta's Film Classification Board",
    "code": "14A"
  },
  {
    "body": "Departamento de Justiça, Classificação, Títulos e Qualificação",
    "code": "14"
  },
  {
    "body": "Motion Picture Association of America",
    "code": "PG-13"
  },
  ...additional ratings...
],
  "genres": ["Science fiction","Action"],
  "preferredImage": {
    "uri": "assets/p8288118_p_v5_aa.jpg",
    "height": "360",
    "width": "240",
    "primary": "true",
    "category": "Poster Art",
    "caption": {
      "content": "Battle: Los Angeles (2011)",
      "lang": "en"
    }
  },
  "releaseYear": 2011,
  "qualityRating": {
    "ratingsBody": "TMS",
    "value": "2"
  },
  "officialUrl": "http://www.battlela.com/",
  "advisories": ["Adult Language","Violence","Adult Situations"],
  "cast": [{
    "personId": "73023",
    "nameId": "73023",
    "name": "Aaron Eckhart",
    "role": "Actor",
    "characterName": "Ssgt. Michael Nantz",
    "billingOrder": "01"
  },
  {
    "personId": "219616",
    "nameId": "222033",
    "name": "Michelle Rodriguez",
    "role": "Actor",
    "characterName": "Tsgt. Elena Santos",
    "billingOrder": "02"
  },
  {
    "personId": "52901",
    "nameId": "52901",
    "name": "Ramon Rodriguez",
    "role": "Actor",
    "characterName": "2nd Lt. William Martinez",
    "billingOrder": "03"
  },
  ...additional cast...
  ],
  "crew": [{
    "personId": "267211",
    "nameId": "270791",
    "name": "Jonathan Liebesman",
    "role": "Director",
    "billingOrder": "01"
  },
  {
    "personId": "341476",
    "nameId": "350350",
    "name": "Chris Bertolini",
    "role": "Screenwriter",
    "billingOrder": "02"
  },
  {
    "personId": "274004",
    "nameId": "318356",
    "name": "Neal H. Moritz",
    "role": "Producer",
    "billingOrder": "03"
  },
  ...additional crew...
  ],
  "directors": ["Jonathan Liebesman"],
  "runTime": "PT01H56M",
  "entityType": "Movie"
}

Example 3 - Sports Event Program Record

{
  "tmsId": "SP002900240000",
  "rootId": "10298347",
  "seriesId": "191276",
  "title": "NBA Basketball",
  "titleLang": "en",
  "shortDescription": "From Barclays Center in Brooklyn, N.Y.",
  "longDescription": "From Barclays Center in Brooklyn, N.Y.",
  "descriptionLang": "en",
  "genres": ["Basketball"],
  "eventTitle": "Miami Heat at Brooklyn Nets",
  "subType": "Sports event",
  "gameDate": "2014-01-10",
  "gameTime": "20:00:00-05:00",
  "gameTimeZone": "Eastern Observing",
  "organizationId": "19",
  "sportsId": "59",
  "teams": [
    {"name": "Miami Heat", "teamBrandId": "414"},
    {"name": "Brooklyn Nets", "isHome": true, "teamBrandId": "7277"}
  ],
  "venue": {
    "content": "Barclays Center",
    "venueBrandId": "1257"
  },
  "season": {
    "content": "2013-2014",
    "type": "Reg"
  },
  "preferredImage": {
    "uri": "assets/p191276_b_v5_aa.jpg",
    "height": "360",
    "width": "240",
    "primary": "true",
    "category": "Banner-L3",
    "tier": "Sport"
  },
  "entityType": "Sports"
}