Enhanced Celebrity Requests and Responses

Enhanced Celebrity is an additional entitlement to extend the Celebrities endpoint , including:

• Nationality
• Ethnicity
• Participant Types
• Biographies
• Relationships
• Relationship Events
• Education
• Milestones
• Notes
• Quotes
• Enhanced Awards
• Highlights
• Social Media
• Enhanced Images (baselineAssets)

Request Parameters

Parameter	Required?	Description
api_key	Yes	24-character key obtained during application registration
updateId	No	Update token. Returns celebrities beginning with specified updateId, which is sequential numeric offset received in response.
limit	No	Batch size. Maximum number of celebrities to be returned by API. Use with updateId.
personId	No	For non-batch lookups. Comma-separated list of personIds for celebrity data. Use lookup calls for QA and troubleshooting purposes only. Gracenote does not support lookup APIs for Client production environments.

Example Requests

Return full list of celebrities in batches of 1000:
http://on-api.gracenote.com/v3/Celebrities?updateId=0&limit=1000&api_key=<your-api-key>

Return a specific celebrity:
http://on-api.gracenote.com/v3/Celebrities?personId=100&api_key=<your-api-key>

Example Response

The links below are is a response of Enhanced Celebrity entitlement for The Rock.

Request
http://on-api.gracenote.com/v3/Celebrities?personId=235135&api_key=<your-api-key>

Response: The Rock Enhanced Celebrity Response