Sports

sports/v1/Sports

Helper API to download sports and their related IDs (baseball, football etc).

Response Schema: http://developer.tmsapi.com/files/gracenote_sports_sports_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.

Response Body

Response Description
id Unique id for the sport.
name Name of the sport. (i.e, Football)
parentSport
id Name of the sport. (i.e, Football)
name The name of the parent sport, if applicable.

Sample Response

 

<?xml version="1.0" encoding="UTF-8" ?>
<gracenoteSports xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="gracenote_sports_1.0.xsd" schemaVersion="1.0">
    <header>
        <content>Gracenote Sports - Sports</content>
        <created>2015-09-02T23:11:26Z</created>
        <copyright>Copyright 2015-present. Gracenote, Inc. All rights reserved.</copyright>
        <requestParameters>
            <requestParameter name="updateId">0</requestParameter>
        </requestParameters>
    </header>
    <sports>
        <sport sportId="17592186045471" updateId="7"  >
            <name lang="en">Golf</name>
        </sport>
        <sport sportId="17592186045472" updateId="8"  >
            <name lang="en">Auto Racing</name>
        </sport>
        <sport sportId="17592186045466" updateId="9"  >
            <name lang="en">Baseball</name>
        </sport>
        <sport sportId="17592186045469" updateId="10"  >
            <name lang="en">Basketball</name>
        </sport>
        <sport sportId="17592186045468" updateId="11"  >
            <name lang="en">Soccer</name>
        </sport>
        <sport sportId="17592186045467" updateId="12"  >
            <name lang="en">Football</name>
        </sport>
        <sport sportId="17592186045470" updateId="13"  >
            <name lang="en">Hockey</name>
        </sport>
    </sports>
</gracenoteSports>