Events

sports/v1/Events

Sports events (games, races, tournaments).

Response schema: http://developer.tmsapi.com/files/gracenote_sports_events_1.0.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 No

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

sportId No Comma-separated list of sport identifiers; can be used to filter events, organizationSeasons and teamSeasons APIs.

Response Body

Response

Description

eventId

Unique id for the event.

updateId The updateId for the event.

xids

Container for external ids such as SportsDirect IDs for events, sports etc. to connect to stats and program data.

xid datasource

The specific datasource of id such as “sportsdirect/id” or gracenote/on/program/rootid

gender

The gender of the event: Male, Female, Mixed

seasons

 

season

Season name for event (e.g., 2015)

seasonType

Pre, Regular, Post

status

The status of the event. Includes scheduled, in progress, closed, postponed, rescheduled, canceled.

startDate

The startDate of the event (local time).

startTime

The startTime of the event (UTC)

timeZone

IANA-standard timezone string; indicates local timezone of the event.

timeZoneTms

For compatibility with On products, nonstandard timezone string (translation to offset found in on_common). 

sport

sport related elements

id

The unique ID of the sport played in event.

name

Sport name; referential only.

venue

Venue related elements.

id

The unique ID of the venue where event takes place.

name

Venue name; referential only.

participants

Participant related elements. May be teams or individuals.  May have any number.

teamSeasons

 

id

The unique ID of the franchise.

fullName

The full name of the team, i.e.; “Baltimore Orioles”

isHome

Boolean value, true or false.

organizationSeasons

Organization related elements.

organizationSeason

The unique ID for the organization. May include multiple organizations such as MLB, National League and NL Central.

id

The unique ID for the organizationSeason

name

The name of the organization.

parentEvent

Single parent event.

id

The unique ID of the parent event.

name

The name of the parent event, i.e.; “2015 MLB Playoffs”.

 

Sample Response

 

<?xml version="1.0" encoding="UTF-8" ?>
<gracenoteSports xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="gracenote_sports_events_1.0.xsd" schemaVersion="1.0">
    <header>
        <content>Gracenote On Entertainment Sports - Events</content>
        <created>2015-10-29T19:50:40Z</created>
        <copyright>Copyright 2015-present. Gracenote, Inc. All rights reserved.</copyright>
        <requestParameters>
            <requestParameter name="updateId">0</requestParameter>
            <requestParameter name="limit">5</requestParameter>
        </requestParameters>
    </header>
    <events>
        <event eventId="17592186130535" updateId="6632"   >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/competition:383235</xid>
                <xid datasource="gracenote/on/program/rootId">11487301</xid>
            </xids>
            <status>Scheduled</status>
            <gender>Male</gender>
            <seasonType>Regular</seasonType>
            <startDate>2015-08-05</startDate>
            <startTime>19:30:00</startTime>
            <timeZone>America/Los_Angeles</timeZone>
            <timeZoneTms>Pacific Observing</timeZoneTms>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
            <venue venueId="17592186051002">
                <name lang="en">O.co Coliseum</name>
            </venue>
            <participants>
                <teamSeason teamSeasonId="17592186101598">
                    <fullName lang="en">Oakland Athletics</fullName>
                    <isHome>true</isHome>
                </teamSeason>
                <teamSeason teamSeasonId="17592186101631">
                    <fullName lang="en">Baltimore Orioles</fullName>
                </teamSeason>
            </participants>
            <organizationSeasons>
                <organizationSeason organizationSeasonId="17592186101491">
                    <name lang="en">MLB Baseball</name>
                    <startYear>2015</startYear>
                    <endYear>2015</endYear>
                </organizationSeason>
            </organizationSeasons>
        </event>
        <event eventId="17592186204135" updateId="6633"   >
            <xids>
                <xid datasource="sportsdirect/id">/sport/soccer/competition:69433</xid>
                <xid datasource="gracenote/on/program/rootId">10911469</xid>
            </xids>
            <status>Completed</status>
            <gender>Male</gender>
            <seasonType>Regular</seasonType>
            <startDate>2014-10-18</startDate>
            <startTime>14:00:00</startTime>
            <timeZone>America/New_York</timeZone>
            <timeZoneTms>Eastern Observing</timeZoneTms>
            <sport sportId="17592186045468">
                <name lang="en">Soccer</name>
            </sport>
            <venue venueId="17592186057027">
                <name lang="en">Turf Moor</name>
            </venue>
            <participants>
                <teamSeason teamSeasonId="17592186202400">
                    <fullName lang="en">Burnley FC</fullName>
                    <isHome>true</isHome>
                </teamSeason>
                <teamSeason teamSeasonId="17592186202421">
                    <fullName lang="en">West Ham United FC</fullName>
                </teamSeason>
            </participants>
            <organizationSeasons>
                <organizationSeason organizationSeasonId="17592186202360">
                    <name lang="en">Barclays Premier League</name>
                    <startYear>2014</startYear>
                    <endYear>2015</endYear>
                </organizationSeason>
            </organizationSeasons>
        </event>
        <event eventId="17592186114140" updateId="6634"   >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/competition:384365</xid>
                <xid datasource="gracenote/on/program/rootId">11464075</xid>
            </xids>
            <status>Scheduled</status>
            <gender>Male</gender>
            <seasonType>Regular</seasonType>
            <startDate>2015-05-26</startDate>
            <startTime>23:00:00</startTime>
            <timeZone>America/New_York</timeZone>
            <timeZoneTms>Eastern Observing</timeZoneTms>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
            <venue venueId="17592186048372">
                <name lang="en">Tropicana Field</name>
            </venue>
            <participants>
                <teamSeason teamSeasonId="17592186101586">
                    <fullName lang="en">Seattle Mariners</fullName>
                </teamSeason>
                <teamSeason teamSeasonId="17592186101623">
                    <fullName lang="en">Tampa Bay Rays</fullName>
                    <isHome>true</isHome>
                </teamSeason>
            </participants>
            <organizationSeasons>
                <organizationSeason organizationSeasonId="17592186101491">
                    <name lang="en">MLB Baseball</name>
                    <startYear>2015</startYear>
                    <endYear>2015</endYear>
                </organizationSeason>
            </organizationSeasons>
        </event>
        <event eventId="17592186114123" updateId="6635"   >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/competition:385304</xid>
                <xid datasource="gracenote/on/program/rootId">11464078</xid>
            </xids>
            <status>Scheduled</status>
            <gender>Male</gender>
            <seasonType>Regular</seasonType>
            <startDate>2015-05-26</startDate>
            <startTime>00:00:00</startTime>
            <timeZone>America/Chicago</timeZone>
            <timeZoneTms>Central Observing</timeZoneTms>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
            <venue venueId="17592186047726">
                <name lang="en">Miller Park</name>
            </venue>
            <participants>
                <teamSeason teamSeasonId="17592186101510">
                    <fullName lang="en">San Francisco Giants</fullName>
                </teamSeason>
                <teamSeason teamSeasonId="17592186101497">
                    <fullName lang="en">Milwaukee Brewers</fullName>
                    <isHome>true</isHome>
                </teamSeason>
            </participants>
            <organizationSeasons>
                <organizationSeason organizationSeasonId="17592186101491">
                    <name lang="en">MLB Baseball</name>
                    <startYear>2015</startYear>
                    <endYear>2015</endYear>
                </organizationSeason>
            </organizationSeasons>
        </event>
        <event eventId="17592186130495" updateId="6637"   >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/competition:383529</xid>
                <xid datasource="gracenote/on/program/rootId">11487295</xid>
            </xids>
            <status>Scheduled</status>
            <gender>Male</gender>
            <seasonType>Regular</seasonType>
            <startDate>2015-08-04</startDate>
            <startTime>00:00:00</startTime>
            <timeZone>America/Chicago</timeZone>
            <timeZoneTms>Central Observing</timeZoneTms>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
            <venue venueId="17592186048408">
                <name lang="en">U.S. Cellular Field</name>
            </venue>
            <participants>
                <teamSeason teamSeasonId="17592186101582">
                    <fullName lang="en">Chicago White Sox</fullName>
                    <isHome>true</isHome>
                </teamSeason>
                <teamSeason teamSeasonId="17592186101623">
                    <fullName lang="en">Tampa Bay Rays</fullName>
                </teamSeason>
            </participants>
            <organizationSeasons>
                <organizationSeason organizationSeasonId="17592186101491">
                    <name lang="en">MLB Baseball</name>
                    <startYear>2015</startYear>
                    <endYear>2015</endYear>
                </organizationSeason>
            </organizationSeasons>
        </event>
    </events>
</gracenoteSports>