Find Venue by Query

gns-api/venues

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

Response Schema: https://gns-schemas.sports.gracenote.com/gns.xsd / https://gns-schemas.sports.gracenote.com/gns.json

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

Queries

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

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

Response Body

Response

Description

id

Unique Gracenote id for the venue.

xids

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

Sample Request

Query: {"name": "Wembley"}

Sample Response

 

<venues>
        <venue>
            <id>GN2E28V8W0TVT5W</id>
            <meta>
                <update_date>2018-02-27T18:29:36.989Z</update_date>
            </meta>
            <xids>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/football/venue:473</id>
                </xid>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/soccer/venue:905</id>
                </xid>
                <xid>
                    <supplier>tms</supplier>
                    <type>venue</type>
                    <id>1583</id>
                </xid>
                <xid>
                    <supplier>onsports</supplier>
                    <type>venue</type>
                    <id>17592186079901</id>
                </xid>
                <xid>
                    <supplier>infostrada</supplier>
                    <type>general_geo</type>
                    <id>5199</id>
                </xid>
            </xids>
            <names>
                <name>
                    <type>DISPLAY</type>
                    <value>Wembley Stadium</value>
                </name>
            </names>
            <location>
                <city>London</city>
                <country>England</country>
            </location>
        </venue>

Docs Navigation