Find Venue by Venue ID

gns-api/venues

API to return the sport venue(s) for the specific venue ID.

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

Request Parameters

Parameter Mandatory Description
venueId Yes

If you already have a venue's GN id, you can use that to find the venue.

accept Yes

Choose between XML and JSON for the response..

fields No Allows you to return the id(s) and a specific field(s) in the response. In the case of venues, this is limited to "names".

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

venueId: GNAT5AKHMSTTPP9

Sample Response

 <venues>
        <venue>
            <id>GNAT5AKHMSTTPP9</id>
            <meta>
                <update_date>2018-02-02T21:10:31.980Z</update_date>
            </meta>
            <xids>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/baseball/venue:3066</id>
                </xid>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/football/venue:537</id>
                </xid>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/soccer/venue:1149</id>
                </xid>
                <xid>
                    <supplier>tms</supplier>
                    <type>venue</type>
                    <id>131</id>
                </xid>
                <xid>
                    <supplier>onsports</supplier>
                    <type>venue</type>
                    <id>17592186048590</id>
                </xid>
                <xid>
                    <supplier>infostrada</supplier>
                    <type>general_geo</type>
                    <id>42757</id>
                </xid>
            </xids>
            <names>
                <name>
                    <type>DISPLAY</type>
                    <value>Yankee Stadium</value>
                </name>
            </names>
            <location>
                <city>New York, NY</city>
                <country>United States</country>
            </location>
        </venue>
    </venues>

Docs Navigation