Teams

sports/v1/Teams

Instances of teams.

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

teamId

Franchise identifier, to associate teams across seasons regardless of name changes.

updateId The updateId of this entry.
xids Container for external ids such as SportsDirect IDs for events, sports etc. to connect to stats data.
xid datasource The specific datasource of id such as “SportsDirect”

fullName

Full team name.  (i.e., New York Giants)

firstName

First section of team name (i.e.; New York)

lastName

Last section of team name (i.e.; Giants)

abbreviation

Team name abbreviation (i.e.; NYG)

gender

Male, Female, Mixed

venue

Reference to the team’s primary venue; useful for location-based team queries.

id

Unique identifier for the venue.

name

Name of the venue.

organizationSeason

Reference to the team’s organizations (all parent levels).

id

Unique identifier for the organizationSeason.

name

Name of the organizationSeason

sport

 

id

Unique identifier for the related sport.

Name

Name of the related sport.

 

Sample Response

 

<?xml version="1.0" encoding="UTF-8" ?>
<gracenoteSports xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="gracenote_sports_teams_1.0.xsd" schemaVersion="1.0">
    <header>
        <content>Gracenote Sports - Teams</content>
        <created>2015-09-03T21:51:01Z</created>
        <copyright>Copyright 2015-present. Gracenote, Inc. All rights reserved.</copyright>
        <requestParameters>
            <requestParameter name="updateId">0</requestParameter>
            <requestParameter name="limit">5</requestParameter>
        </requestParameters>
    </header>
    <teams>
        <team teamId="17592186099658" updateId="194"  >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/team:2962</xid>
            </xids>
            <fullName lang="en">San Francisco Giants</fullName>
            <firstName lang="en">San Francisco</firstName>
            <lastName lang="en">Giants</lastName>
            <abbreviation lang="en">SF</abbreviation>
            <gender>Male</gender>
            <venue venueId="17592186046978">
                <name lang="en">AT&amp;T Park</name>
            </venue>
            <organization organizationId="17592186045498">
                <name lang="en">NL West</name>
            </organization>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
        </team>
        <team teamId="17592186099649" updateId="195"  >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/team:2979</xid>
            </xids>
            <fullName lang="en">Los Angeles Angels of Anaheim</fullName>
            <firstName lang="en">Los Angeles</firstName>
            <lastName lang="en">Angels</lastName>
            <abbreviation lang="en">LAA</abbreviation>
            <gender>Male</gender>
            <venue venueId="17592186046931">
                <name lang="en">Angel Stadium of Anaheim</name>
            </venue>
            <organization organizationId="17592186045494">
                <name lang="en">AL West</name>
            </organization>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
        </team>
        <team teamId="17592186099699" updateId="196"  >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/team:2968</xid>
            </xids>
            <fullName lang="en">Arizona Diamondbacks</fullName>
            <firstName lang="en">Arizona</firstName>
            <lastName lang="en">Diamondbacks</lastName>
            <abbreviation lang="en">ARI</abbreviation>
            <gender>Male</gender>
            <venue venueId="17592186047106">
                <name lang="en">Chase Field</name>
            </venue>
            <organization organizationId="17592186045498">
                <name lang="en">NL West</name>
            </organization>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
        </team>
        <team teamId="17592186099674" updateId="197"  >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/team:2975</xid>
            </xids>
            <fullName lang="en">St. Louis Cardinals</fullName>
            <firstName lang="en">St. Louis</firstName>
            <lastName lang="en">Cardinals</lastName>
            <abbreviation lang="en">STL</abbreviation>
            <gender>Male</gender>
            <venue venueId="17592186047079">
                <name lang="en">Busch Stadium</name>
            </venue>
            <organization organizationId="17592186045497">
                <name lang="en">NL Central</name>
            </organization>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
        </team>
        <team teamId="17592186099807" updateId="198"  >
            <xids>
                <xid datasource="sportsdirect/id">/sport/baseball/team:2961</xid>
            </xids>
            <fullName lang="en">Cincinnati Reds</fullName>
            <firstName lang="en">Cincinnati</firstName>
            <lastName lang="en">Reds</lastName>
            <abbreviation lang="en">CIN</abbreviation>
            <gender>Male</gender>
            <venue venueId="17592186047443">
                <name lang="en">Great American Ball Park</name>
            </venue>
            <organization organizationId="17592186045497">
                <name lang="en">NL Central</name>
            </organization>
            <sport sportId="17592186045466">
                <name lang="en">Baseball</name>
            </sport>
        </team>
    </teams>
</gracenoteSports>