Find Venue by Query


API to return the venue(s) for a specific query.

Response Schema: /

Request Parameters

Parameter Mandatory Description Example(s) 
query Yes

Make a request based on a specific query. See examples below.

accept Yes

Choose between XML and JSON for the response..

skip No Indicate the number of results to skip in the response.
limit No Indicate the maximum number of results in the response.
fields No Allows you to return the id(s) and only specific field(s) in the response. names


Query Description Example
name Make a request based on the name (or partial name) of a venue(s).

{"name": "Wembley Stadium"} 

{"name": "Staples"} 

city, state or country Make a request based on the city, state (if appliocable) or country for the venue(s).

{"city": "Boston"}

{"country": "Italy"}

Make a request for persons based on gender.
{"gender": "MALE"}
{} Returns all persons.

Response Body




Unique Gracenote id for the venue.


Container for external ids to connect to data in other Gracenote APIs and/or legacy data.

supplier Name of the supplier (e.g. sportsdirect, infostrada, onsports, tms) of the xid.
type The description of the supplier's id keyspace.
id The supplier's id for the associated entity.
name The name(s) of the venue.
type The type of name for the venue (e.g. DEFAULT, SHORT).
value The value for the type of name for the venue (e.g. Yankee Stadium)
location The location for the venue.
city The city for the venue.
state The state for the venue, if applicable.
country The country for the venue.


Sample Request

Query: {"name": "Wembley"}

Sample Response


                    <value>Wembley Stadium</value>