Events

TvSportsData/Events

Returns all sports events. Events represent matches (e.g. Philadelphia-NY Giants) as well as league/conference/division seasons (e.g. 2016-2017 NFL, 2016-2017 NFC, 2016-2017 NFC East) and league/conference/division season phases (e.g. NFL 2016-2017 Regular Season, NFL 2016-2017 Regular Season - Week 1).

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 event.

update_id The update id for the event.
update_action The update action for the event.
update_date The update date and time for the event.

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) of the xid.
type The description of the supplier's id keyspace.
id The supplier's id for the associated entity.
description A description for the event.
type The type of event (e.g. MATCH, LEAGUE_SEASON, CONFERENCE_SEASON, etc.).
start_time The date and time (UTC) when the event starts or started.
end_time The date and time (UTC) when the event ends or ended, if applicable.
status The status (e.g. SCHEDULED, IN_PROGRESS, COMPLETED) of the event.
attendance The attendance for the event ("match" type only), if applicable.
sport_id The id for the sport related to the event.
phase_id For "phase" type events only, the phase related to the event.
venue_id The venue id for the event, if applicable.
sports_organization_ids The ids for any organizations related to the event.
parent_sports_event_ids The ids for any parent events for the event.
weather_conditions The weather conditions for an event, if applicable.
temperature_fahrenheit The temperature of the event in fahrenheit, if applicable.
temperature_celsius The temperature of the event in celsius, if applicable.
wind_speed_miles The wind speed for the event in miles, if applicable.
wind_speed_kilometers The wind speed for the event in kilometers, if applicable.
wind_direction The wind direction (e.g. SOUTH) of the event, if applicable.
weather_type The weather type for an event (e.g. CLOUDY), if applicable.
baseball_home_plate_wind_direction For baseball, the wind direction in relation to home plate (e.g. OUT_TO_CENTER), if applicable.

 

Sample Response(s)

 

EVENT (MATCH):

<gns:gns xmlns:gns="http://xml.gracenote.com/gns/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="gns.xsd">
    <sports_events>
        <sports_event>
            <id>GN72Q90FQ2PAFP1</id>
            <meta>
                <update_id>47048</update_id>
                <update_action>UPDATE</update_action>
                <update_date>2017-05-24T15:02:40Z</update_date>
            </meta>
            <xids>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/baseball/competition:550549</id>
                </xid>
                <xid>
                    <supplier>onsports</supplier>
                    <type>event</type>
                    <id>17592187859481</id>
                </xid>
            </xids>
            <description>NY Yankees-Tampa Bay</description>
            <type>MATCH</type>
            <start_time>2017-05-20T20:10:00Z</start_time>
            <status>COMPLETED</status>
            <attendance>22864</attendance>
            <sport_id>GN3FAZE2HJTVDJ9</sport_id>
            <venue_id>GN69VGY7RPGXXDS</venue_id>
            <sports_organization_ids>
                <value>GNCH1JZA56P7PKE</value>
            </sports_organization_ids>
            <parent_sports_event_ids>
                <value>GN1CZ62RQT2X0R8</value>
                <value>GN29MBC7Y40D41R</value>
            </parent_sports_event_ids>
            <weather_conditions>
                <temperature_fahrenheit>72</temperature_fahrenheit>
                <temperature_celsius>22.22222137451172</temperature_celsius>
            </weather_conditions>
        </sports_event>
    </sports_events>
</gns:gns>

EVENT (LEAGUE_SEASON):

<gns:gns xmlns:gns="http://xml.gracenote.com/gns/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="gns.xsd">
    <sports_events>
        <sports_event>
            <id>GN29MBC7Y40D41R</id>
            <meta>
                <update_id>913638</update_id>
                <update_action>UPDATE</update_action>
                <update_date>2017-06-05T12:53:01Z</update_date>
            </meta>
            <xids>
                <xid>
                    <supplier>sportsdirect</supplier>
                    <type>xml</type>
                    <id>/sport/baseball/season:1068</id>
                </xid>
            </xids>
            <description>2017 - MLB</description>
            <type>LEAGUE_SEASON</type>
            <start_time>2017-01-02T00:00:00Z</start_time>
            <end_time>2017-11-29T00:00:00Z</end_time>
            <sport_id>GN3FAZE2HJTVDJ9</sport_id>
            <sports_organization_ids>
                <value>GNCH1JZA56P7PKE</value>
            </sports_organization_ids>
            <parent_sports_event_ids>
                <value>GN1CZ62RQT2X0R8</value>
            </parent_sports_event_ids>
        </sports_event>
    </sports_events>
</gns:gns>