Celebrity Metadata

Important: This site is the API Gateway for Gracenote Video and Sports. As of September 08, 2026, the documentation and API explorers (I/O docs) for active products will move to the new Gracenote Developer Portal. Please use this new portal moving forward. Set up your new dev portal account using the login email for this site. The legacy documentation on this site will remain until further notice. Please contact your Gracenote representative or Gracenote Support for assistance.

Field / object	Type	Notes
personId	string	resource id, uniquely identifies celebrity in one record, regardless of name changes
entityType	string	identifies data as Celebrity record
name	Name	name metadata includes separate fields for first name, last name, and name id
birthPlace	string	city, state (US), country (international)
birthDate	date	yyyy-mm-dd
deathDate	date	yyyy-mm-dd
gender	string	M, F or N (Non-Binary)
preferredImage	Image	celebrity image; if none found, generic image will be returned
alternateNames	Name [ ]	list of other names by which celebrity may be known
awards	Award [ ]	list of entertainment industry awards won
credits	Credit [ ]	mediography information, including program and role details

Example


{
   "personId": "56714",
   "entityType": "Celebrity",
   "name": {
      "first": "Roseanne",
      "last": "Barr",
      "nameId": "171296"
   },
   "birthPlace": "Salt Lake City, Utah",
   "birthDate": "1952-11-03",
   "gender": "F",
   "preferredImage": {
      "uri": "celebs/v3/NowShowing/56714/56714_v3_ba.jpg",
      "height": "360",
      "width": "270",
      "category": "Photo - headshot"
   },
   "alternateNames": [{
      "first": "Roseanne",
      "last": "Arnold",
      "nameId": "153382"
   },
   {
      "first": "Roseanne",
      "last": "Thomas",
      "nameId": "506184"
   },
   {
      "first": "Roseanne",
      "nameId": "56714"
   }],
   "awards": [{
      "awardId": "2",
      "rootId": "183903",
      "name": "Golden Globe",
      "category": "Best Performance by an Actress in a Television Series - Musical or Comedy",
      "awardCatId": "120",
      "year": "1992"
   },
   {
      "awardId": "4",
      "rootId": "183903",
      "name": "Emmy (Primetime)",
      "category": "Outstanding Lead Actress in a Comedy Series",
      "awardCatId": "80",
      "year": "1994"
   },
   {
      "awardId": "3",
      "rootId": "183903",
      "name": "Screen Actors Guild Awards",
      "category": "Outstanding Performance by a Female Actor in a Comedy Series",
      "awardCatId": "121",
      "year": "1995"
   }],
   "credits": [{
      "rootId": "12005",
      "role": "Actor",
      "characterName": "Ruth Patchett",
      "title": "She-Devil",
      "year": "1989",
      "type": "movie"
   },
   {
      "rootId": "12922",
      "role": "Voice",
      "characterName": "Julie",
      "title": "Look Who's Talking Too",
      "year": "1990",
      "type": "movie"
   },
   {
      "rootId": "183895",
      "role": "Guest",
      "title": "The Tonight Show With Jay Leno",
      "type": "show"
   },
   {
      "rootId": "183903",
      "role": "Actor",
      "title": "Roseanne",
      "type": "show"
   },
   {
      "rootId": "183903",
      "role": "Executive Producer",
      "title": "Roseanne",
      "type": "show"
   }]
}