Advanced Discovery and Video Descriptors

Video Descriptor Taxonomy Items API

v1/videodescriptortaxonomyitems

Returns the hierarchical taxonomy for Video Descriptors, grouped by Taxonomy Items (aka Video Descriptor Type). Each Video Descriptor Type is considered one object and is available as a Video Descriptor Taxonomy Item. The Video Descriptors feature is sold separately. Contact your Gracenote representative to get this feature.

Parameters

Parameter	Type	Description
updateId	string	Returns full snapshot of Video Descriptors that belong to a Taxonomy Item (aka Video Descriptor Type), modified at or after updateId. Individual Video descriptors updates are not published independently
limit	string	Maximum number of a Video Descriptor Taxonomy Items to be returned by the API
Id	string	Used for a lookup of all Video descriptors that belong to a single Taxonomy Item (aka Video Descriptor Type). Example all descriptors under Scenario (id = GN0FYAPK8TW10ZF)
api_key	string	Gracenote API Key

Sample Request

Code
 
http://gvd-api.gracenote.com/v1/videodescriptortaxonomyitems?api_key=&streamId=0&updateId=0&limit=10

Request Parameters

Parameter	Mandatory?	Description
limit	No	To be used in conjunction with updateId to limit a response to specified number of Video Descriptor Types. If not specified, all Video Descriptor Types are provided in response.
Id	No	Retrieve keywords belonging to specific type. To be used for evaluation and troubleshooting purposes, not programmatic ingestion.
updateId	No	Unique update token, used to retrieve Video Descriptor Taxonomy data at a type level. Since the type is the most granular form of update from this endpoint, when a keyword within a type is updated, a snapshot of all keywords that belong to that type is published. This can also be combined with the limit parameter to ingest specified batch size. For example, a limit of 1 provides all keywords belonging to one type. Using limit of 7 will provide all keywords currently available across 7 types.
api_key	Yes	Customer-specific key to allow access to the APIs.

Last modified on November 13, 2025

Video Descriptor Taxonomy Endpoint Video Popularity

Video Descriptor Taxonomy Items API

v1/videodescriptortaxonomyitems

Parameters

Parameter

Value

Type

Description

updateId

string

Returns full snapshot of Video Descriptors that belong to a Taxonomy Item (aka Video Descriptor Type), modified at or after updateId. Individual Video descriptors updates are not published independently

limit

string

Maximum number of a Video Descriptor Taxonomy Items to be returned by the API

string

Used for a lookup of all Video descriptors that belong to a single Taxonomy Item (aka Video Descriptor Type). Example all descriptors under Scenario (id = GN0FYAPK8TW10ZF)

api_key

string

Gracenote API Key

Request Parameters

Parameter

Mandatory?

Description

limit

To be used in conjunction with updateId to limit a response to specified number of Video Descriptor Types. If not specified, all Video Descriptor Types are provided in response.

Retrieve keywords belonging to specific type. To be used for evaluation and troubleshooting purposes, not programmatic ingestion.

updateId

Unique update token, used to retrieve Video Descriptor Taxonomy data at a type level. Since the type is the most granular form of update from this endpoint, when a keyword within a type is updated, a snapshot of all keywords that belong to that type is published. This can also be combined with the limit parameter to ingest specified batch size. For example, a limit of 1 provides all keywords belonging to one type. Using limit of 7 will provide all keywords currently available across 7 types.

api_key

Yes

Customer-specific key to allow access to the APIs.

Last modified on November 13, 2025