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