Venues

TvSportsData/Venues

Returns all sports venues.

Response schema: http://gns-schemas.sports.gracenote.com/gns.xsd

Request Parameters

Parameter Mandatory Description
updateId Yes

Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records.

limit Yes

Maximum number of objects to retrieve for processing predictiable batch sizes. Each iteration would retain limit number for same batch size.

Response Body

Response

Description

id

Unique Gracenote id for the venue.

update_id The update id for the venue.
update_action The update action for the venue.
update_date The update date and time 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 Response(s)

 

VENUE:

<gns:gns xmlns:gns="http://xml.gracenote.com/gns/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="gns.xsd">
        <venues>
            <venue>
                <id>GNAT5AKHMSTTPP9</id>
                <meta>
                    <update_id>1274665</update_id>
                    <update_action>UPDATE</update_action>
                    <update_date>2017-06-08T18:03:34Z</update_date>
                </meta>
                <xids>
                    <xid>
                        <supplier>sportsdirect</supplier>
                        <type>xml</type>
                        <id>/sport/baseball/venue:3066</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>36650</id>
                    </xid>
                </xids>
                <names>
                    <name>
                        <type>DEFAULT</type>
                        <value>Yankee Stadium</value>
                    </name>
                    <name>
                        <type>SHORT</type>
                        <value>YS</value>
                    </name>
                </names>
                <location>
                    <city>Bronx</city>
                    <state>New York</state>
                    <country>USA</country>
                </location>
                <timezone>US/Eastern</timezone>
            </venue>
        </venues>
    </gns:gns