• Register

Credits 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

nameId string resource id, identifies one name variation for celebrity
name string celebrity name coresponding to nameId; first and last name
rootId string rootId of program for which credit applies
title string title of program corresponding to rootId
year string indicates date of release of rootId program; applicable only for movies
role string description of cast/crew role (e.g., Actor, Director, Screenwriter, Guest)
billingOrder string order in which credit should be listed
characterName string applicable to cast metadata only; name of program character
type string program type (e.g., movie, show)

Example - Cast member


{
   "personId": "435166",
   "nameId": "444041",
   "name": "Sofía Vergara",
   "rootId": "8696245",
   "title": "Happy Feet Two",
   "role": "Voice",
   "billingOrder": "07",
   "characterName": "Carmen",
   "year": "2011",
   "type": "movie"
}

Example - Crew member


{
   "personId": "79220",
   "nameId": "79220",
   "name": "Paul Livingston",
   "rootId": "8696245",
   "title": "Happy Feet Two",
   "role": "Screenwriter",
   "billingOrder": "05",
   "year": "2011",
   "type": "movie"
}