ESPN Teams Data

Teams

Smells like team spirit
  • The ESPN Teams API enables you to get information, including roster, stats, and more, for individual teams. You can also fetch teams by conference or division.

    This API is currently a version 1 (/v1/) release.

    Availability
    Public Strategic Partner ESPN
  • The ESPN Teams API accepts a GET request.

    Team information is available for most major sports.

    The format of an API request is as follows:
    http://api.espn.com/:version/:resource/:method?apikey=:yourkey

    Sample Teams Requests

    Action URI Description
    GET http://api.espn.com/v1/sports/baseball/mlb/teams All MLB teams.
    GET http://api.espn.com/v1/sports/baseball/mlb/teams/2 Specific MLB team.
    GET http://api.espn.com/v1/sports/baseball/mlb/teams/2?enable=roster Specific MLB team, including the current roster. Subject to access tier.
    GET http://api.espn.com/v1/sports/baseball/mlb/teams?groups=1 All teams within the American League East division in MLB.
    GET http://api.espn.com/v1/sports/baseball/mlb/teams?groups=1&lang=es All teams within the American League East division in MLB, with Spanish-language option enabled.
  • Quick Navigation

    Resources

    Resource Name Description Availability
    public strategic
    partner
    espn
    /sports/baseball/mlb Major League Baseball (MLB)
    /sports/basketball/mens-college-basketball NCAA Men's College Basketball
    /sports/basketball/nba National Basketball Association (NBA)
    /sports/basketball/wnba Women's National Basketball Association
    /sports/basketball/womens-college-basketball NCAA Women's College Basketball
    /sports/football/college-football NCAA College Football
    /sports/football/nfl National Football League (NFL)
    /sports/hockey/nhl National Hockey League (NHL)
    /sports/soccer Professional soccer. Useful as soccer teams may participate in more than one league/tournament within a given season.
    /sports/soccer/:leagueName Specific professional soccer league. Use a helper API call for a complete list of supported soccer leagues.
    Back to top

     

    Methods

    Method Description Availability
    public strategic
    partner
    espn
    /teams Retrieves a list of teams within a sport and league, with corresponding API links.
    /teams/:id Returns information about a specific team.
    Back to top

     

    URI Parameters

    Parameter Description Availability
    public strategic
    partner
    espn
    dates Optional flag to return players on the roster for a team in a specific year. Accepts an integer year in the form "yyyy". For example, "dates=2012".
    enable Optional flag to enable specific information, with the following options. Accepts a single value or a comma-delimited string of values. For example, "enable=leaders,venues".
    headshot Returns links to player headshots in various sizes. Use in conjunction with the headshotsize parameter to return specific image sizes.
    leaders Returns stats leader nodes within a statLeaders object. See the Leaders API for details about available leader statistics.
    ranks Returns an array of rank objects corresponding to the competitor, such as AP Poll, USA Today Poll, BCS Ranking and ESPN Power Ranking. Available rank types vary by sport.
    roster Returns the team roster within an athletes array. Can only be used when specifying a single team, otherwise is ignored.
    statistics Returns team-specific statistics in a statistics array. See the What it Returns page for details about the statistics supported for each sport.
    stats DEPRECATED Returns team-specific statistics in a stats object. Do not use this parameter for new development. Future support is not guaranteed.
    venues Returns venue/stadium information for the team.
    groups Integer. Returns events for only the specific group/division ID specified. For example, "groups=7". To see a list of group IDs for a given league, use the Helper API calls. Not applicable to golf and tennis.
    headshotsize Optional flag to return a specific headshot images size when the "enable=headshot" parameter is used. Accepts a single value. For example, "enable=headshot&headshotsize=large". Supported sizes include full (600×436), xlarge (350×254), large (65×90), medium (43×60), small (34×48), xsmall (28×38), fantasy (200×145) and gamecast (120×90).
    lang Optional flag to return content in a specified language. Note: not all content is available in multiple languages and will return in English if no alternative is available. Supported languages include:
    en English. Default language.
    es Spanish.
    logosize Optional flag to limit team logos to a specific size. Supported sizes include: full (500×500), large (110×110), medium (80×80), small (50×50), xsmall (40×40) and xxsmall (25×25).
    rostertype When the "enable=roster" parameter is used, specifies the type of roster to return. Note: this option is only valid for MLB. Accepts the following values
    full Returns the full team roster (including injured/inactive players). This is the default roster view.
    active Returns only active players.
    zipcode Integer. Optional flag to return relevant teams corresponding to an area specified by a 5-digit zip code.
    Back to top

     

  • Quick Navigation

    Returned Data

    Requests to this API return the following data.

    Sports Object

    The sports array is the base object returned by requests on the Teams API. It typically contains a single object referencing the sport specified in the endpoint used by the API request.

    Element Description Availability
    public strategic
    partner
    espn
    name String name of the sport.
    id Integer ID of the sport.
    uid String identifier for the sports entity in ESPN's systems.
    leagues Array containing data for a league within the sport. See the Leagues Object for details.
    Back to top

    Leagues Object

    Element Description Availability
    public strategic
    partner
    espn
    name String full name of the league. For example, "National Football League".
    abbreviation String lowercase abbreviation of the league name. For example, "nfl".
    id Integer ID of league within the sport.
    uid String identifier for the league in ESPN's systems.
    groupId Integer ID of the conference or division within the league.
    shortName String abbreviation of the league name suitable for display. For example, "NFL".
    teams Array containing data for teams within the league or a single team if using the teams/:teamID method. See the Teams Object for details.
    Back to top

    Teams Object

    The central object of the Teams API, the teams array contains one or more team objects containing data about the team.

    When requesting data for a specific team using the /teams/:teamID method, all team data will be within index 0 of the array.

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of team within the league.
    uid String identifier for the team in ESPN's systems.
    location String team location, typically the city or state associated with the team name.
    name String team name.
    nickname String team nickname.
    abbreviation String two or three-letter abbreviation suitable for use in a space constrained displays like a scoreboard.
    color Hexadecimal value of the team's identifying color.
    logos Object containing links to team logo images in various sizes. See the Logos Object for details.
    groups Array containing objects defining the team's conference or division affiliation within the league. See the Groups Object for details.
    venues Array containing objects defining the team's home stadium or sports facility. Included in the response when using the "enable=venues" parameter in the request. See the Venues Object for details.
    record Object containing a summary of the team's win-loss record for the season specified in the request. See the Record Object for details.
    ranks Array containing objects defining the team's ranking in supported polls and ranking systems. Included in the response when using the "enable=ranks" parameter in the request. See the Ranks Object for details.
    statistics Array containing objects reporting the team's statistics in various sport-related categories. Included in the response when using the "enable=statistics" parameter in the request. See the Statistics Object for details.
    stats DEPRECATED Object containing team-specific statistics. Included in the response when using the "enable=stats" parameter in the request. See the Stats Object for details.
    athletes Array containing objects providing data about athletes on the team roster. Included in the response when using the "enable=roster" parameter in the request. See the Athletes API for details.
    statLeaders Array containing team leaders for sport-specific statistical categories. See the Leaders API for details about available leader statistics.
    leaders Object containing team leaders for sport-specific statistical categories. See the Leaders API for details about available leader statistics.
    Back to top

    Logos Object

    The logos object contains objects related to various team logo sizes supported by the Teams API, including full (500×500), large (110×110), medium (80×80), small (50×50), xsmall (40×40) and xxsmall (25×25).

    Limit the response to a single logo size by using the logosize query parameter. For example, "logosize=small".

    Note that soccer support is limited to the following leagues: Spanish Primera Division (esp.1), English Premier League (eng.1), Italian Serie A (ita.1), Portuguese Liga (por.1), Bundesliga (ger.1), Ligue 1 (fra.1), MLS (usa.1), Mexico (mex.1), Copa MX (mex.copa_mx), Primera División de Argentina (arg.1), Fútbol Profesional Colombiano (col.1), and FIFA and world tournaments.

    Each object returned in the logos object includes the following properties:

    Element Description Availability
    public strategic
    partner
    espn
    href String URL of the image file.
    width Integer width of the image in pixels.
    height Integer height of the image in pixels.
    dark Object containing logo properties for a version of the team logo suitable for dark backgrounds, when available.
    scoreboard Object containing logo properties for standard and dark-background versions of a scoreboard team logo, when available.
    Back to top

    Groups Object

    The groups array holds objects defining the team's conference or division affiliations within a league.

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID. Typically -1.
    groupId Integer ID of the conference or division.
    name String name of the conference or division. For example, "Pac 12 - South".
    abbreviation String token for the conference or division name. For example, "pac12Sou".
    Back to top

    Venues Object

    The venues array holds an object defining the team's home facility. Included in the response when using the "enable=venues" parameter in the request.

    Element Description Availability
    public strategic
    partner
    espn
    id Integer ID of the venue.
    name String name of the venue. For example, "Rose Bowl".
    city String name of the venue's location city.
    state String name or abbreviation of the venue's location state or province.
    country String name of the venue's location country.
    capacity Integer maximum capacity of the venue. May be 0 if actual capacity is unavailable.
    isIndoor Boolean indicating whether the venue is enclosed.
    images Object containing links to images of the venue. By default contains a day object with daytime images and, in some cases, a night object containing night images. Each contains additional objects with links to images in various sizes, including full 2000×1125, large (640×360) and medium (320×180). See the Images Object for details.
    Back to top

    Images Object

    The images object provides a common format for image references that appear in several areas of the response. Image references typically include the following properties.

    Element Description Availability
    public strategic
    partner
    espn
    href String URL of the image file.
    width Integer width of the image in pixels.
    height Integer height of the image in pixels.
    Back to top

    Record Object

    The record object contains season win-loss statistics for the team.

    Element Description Availability
    public strategic
    partner
    espn
    summary String summary of the team's win-loss record. For example, "10-6".
    wins Integer wins the specified season.
    losses Integer losses in the specified season.
    overtimeLosses Integer overtime (extra inning) losses for the specified season. Not applicable for all sports.
    ties Integer ties in the specified season.
    season Object containing metadata for the season related to the record data. See the Season Object for details.
    Back to top

    Season Object

    The season object contains season context metadata for record and statistics objects for the team.

    Element Description Availability
    public strategic
    partner
    espn
    year Integer year in which the season started.
    type Integer corresponding to the season type (1 = preseason, 2 = regular season, 3 = postseason).
    description String representation of the season type. For example, "regular" for season type 2.
    startDate Date on which the season starts.
    endDate Date on which the season ends.
    Back to top

    Ranks Object

    When available for the team, the ranks array contains objects specifying the team's ranks, such as such as AP Poll, USA Today Poll, BCS Ranking and ESPN Power Ranking. Available rank types vary by sport. Each rank object includes the following properties.

    Included in the response when using the "enable=ranks" parameter in the request.

    Element Description Availability
    public strategic
    partner
    espn
    type String indicating the type of ranking. Possible values across sports include "power" (ESPN Power Rankings), "ap" (AP Poll), "bcs" (BCS Ranking)", "seed" (Seed in current tournament).
    name String name of the rank source. For example, "ESPN Power Rankings".
    value Integer indicating ranking position. For example, 1 indicates the top-ranked team.
    Back to top

    Statistics Object

    A statistics array is included in the response when using the "enable=statistics" parameter in the request. Each object in the array contains the following elements.

    Element Description Availability
    public strategic
    partner
    espn
    season Object containing metadata for the season related to the record data. See the Season Object for details.
    statCategories Array of statistics categories for the team. See the Stat Categories Object for details.
    Back to top

    Stat Categories Object

    The statCategories array contains objects for sport and team-specific statistics categories. Each object within the array has the following properties.

    Element Description Availability
    public strategic
    partner
    espn
    name String name of the statistics category.
    description String description of the category, suitable for display.
    stats Array of objects containing individual team statistics. See the Stat Categories and Statistics section below for sport-specific statistics details.
    Back to top

    Stats Object - DEPRECATED

    Provides team-specific statistics in a stats object. Do not use this parameter for new development. Future support is not guaranteed.

    Included in the response when using the "enable=stats" parameter in the request.

    All stats objects include a default season object. Additional statistics objects returned in the stats object vary by sport. See the Stat Categories and Statistics section below for details.

    Element Description Availability
    public strategic
    partner
    espn
    season Object containing metadata for the season related to the record data. See the Season Object for details.
    Back to top

     

    Stat Categories and Statistics

    Statistic Object Properties

    Although the name and type of individual statistics vary, each object has the following common properties.

    Element Description Availability
    public strategic
    partner
    espn
    name String name of the statistic.
    description String description of the statisic, suitable for display.
    value Number value reported for the statistic.
    displayValue String value for the statistic, suitable for display.
    abbreviation String short description of the statistic, suitable for scoreboards or space-constrained display.
    Back to top

    College Basketball Stats Extension

    NOTE: The stats object and its properties are DEPRECATED. Do not use these objects and properties for new development. Future support is not guaranteed.

    Category Statistics Object Stats Object
    offense gamesPlayed teamGamesPlayed
    offense points points
    offense pointsPerGame  
    offense fieldGoalsMade fieldGoalsMade
    offense fieldGoalsAttempted fieldGoalsAttempted
    offense fieldGoalPercentage fieldGoalPercentage
    offense threePointFieldGoalsMade threePointersMade
    offense threePointFieldGoalsAttempted threePointersAttempted
    offense threePointFieldGoalPercentage threePointPercentage
    offense freeThrowsMade freeThrowsMade
    offense freeThrowsAttempted freeThrowsAttempted
    offense freeThrowPercentage freeThrowPercentage
    offense pointsPerShot  
    offense adjustedFieldGoalPercentage  
    generalStatistics gamesPlayed teamGamesPlayed
    generalStatistics offensiveRebounds offensiveRebounds
    generalStatistics defensiveRebounds defensiveRebounds
    generalStatistics rebounds rebounds
    generalStatistics reboundsPerGame  
    generalStatistics assists assists
    generalStatistics assistsPerGame  
    generalStatistics blocks blocks
    generalStatistics steals steals
    generalStatistics turnovers turnovers
    generalStatistics fouls fouls
    generalStatistics ejections ejections
    Back to top

    College Football Stats Extension

    NOTE: The stats object and its properties are DEPRECATED. Do not use these objects and properties for new development. Future support is not guaranteed.

    Category Statistics Object Stats Object
    offense gamesPlayed  
    offense yards netTotalYards
    offense points totalPoints
    offense firstDowns  
    offense rushingFirstDowns  
    offense passingFirstDowns  
    offense thirdDownConversions  
    offense thirdDownAttempts  
    offense fourthDownConversions  
    offense fourthDownAttempts  
    offense firstDownPenalties  
    offense penalties  
    offense penaltyYards  
    offense yardsPerGame netYardsPerGame
    offense pointsPerGame totalPointsPerGame
    passing gamesPlayed  
    passing passingAttempts  
    passing completions  
    passing completionPercentage  
    passing passingYards passingYards
    passing longPassing  
    passing passingTouchdowns  
    passing interceptions  
    passing sacks  
    passing sackedYardsLost  
    passing quarterbackRating  
    rushing gamesPlayed  
    rushing rushingAttempts  
    rushing rushingYards rushingYards
    rushing yardsPerRushAttempt  
    rushing longRushing  
    rushing rushingTouchdowns  
    rushing rushingFumbles  
    rushing rushingFumblesLost  
    receiving gamesPlayed  
    receiving receptions  
    receiving receivingYards  
    receiving longReception  
    receiving receivingTouchdowns  
    receiving receivingFumbles  
    receiving receivingFumblesLost  
    defense gamesPlayed  
    defense totalTackles  
    defense unassistedTackles  
    defense assistedTackles  
    defense sacks  
    defense sackYards  
    defense fumblesRecovered  
    defense passesDefended  
    defense interceptions  
    defense interceptionYards  
    defense longInterception  
    defense interceptionTouchdowns  
    defense fumblesForced  
    defense fumblesRecoveredTouchdowns  
    defense kicksBlocked  
    returning gamesPlayed  
    returning kickReturns  
    returning kickReturnYards  
    returning longKickReturn  
    returning kickReturnTouchdowns  
    returning puntReturns  
    returning puntReturnYards  
    returning longPuntReturn  
    returning puntReturnTouchdowns  
    returning puntReturnFairCatches  
    kicking gamesPlayed  
    kicking fieldGoalsMade  
    kicking fieldGoalsAttempted  
    kicking fieldGoalsMade1_19  
    kicking fieldGoalsAttempted1_19  
    kicking fieldGoalsMade20_29  
    kicking fieldGoalsAttempted20_29  
    kicking fieldGoalsMade30_39  
    kicking fieldGoalsAttempted30_39  
    kicking fieldGoalsMade40_49  
    kicking fieldGoalsAttempted40_49  
    kicking fieldGoalsMade50  
    kicking fieldGoalsAttempted50  
    kicking longFieldGoalMade  
    kicking extraPointsMade  
    kicking extraPointsAttempted  
    punting gamesPlayed  
    punting punts  
    punting puntingYards  
    punting longPunt  
    punting grossAveragePuntYards  
    punting netAveragePuntYards  
    punting puntsBlocked  
    punting puntsInside20  
    punting touchbacks  
    punting fairCatches  
    punting puntReturns  
    punting puntReturnYards  
    punting averagePuntReturnYards  
        rushingYardsPerGame
        passingYardsPerGame
    Back to top

    MLB Stats Extension

    NOTE: The stats object and its properties are DEPRECATED. Do not use these objects and properties for new development. Future support is not guaranteed.

    Category Statistics Object Stats Object
    batting gamesPlayed gamesPlayed
    batting atBats atBats
    batting runs runs
    batting hits hits
    batting doubles doubles
    batting triples triples
    batting homeRuns homeRuns
    batting totalBases totalBases
    batting runsBattedIn RBIs
    batting battingAverage average
    batting onBasePercentage onBasePercentage
    batting slugAverage slugAverage
    batting onBasePlusSluggingPercentage OPS
    batting walks walks
    batting strikeouts strikeouts
    batting stolenBases stolenBases
    batting caughtStealing  
    batting plateAppearances  
    batting pitches  
    batting hitByPitch saves
    fielding gamesPlayed  
    fielding errors errors
    fielding fieldingPercentage fieldingPercentage
    fielding assists  
    fielding putouts putouts
    fielding totalChances  
    fielding fullInningsPlayed  
    fielding doublePlays doublePlays
    fielding rangeFactor  
    fielding zoneRating  
    fielding passedBalls  
    pitching gamesPlayed gamesPlayed
    pitching wins wins
    pitching losses losses
    pitching earnedRunAverage ERA
    pitching completeGames completeGames
    pitching shutouts shutouts
    pitching inningsPitched  
    pitching qualityStarts qualityStarts
    pitching earnedRuns earnedRuns
    pitching runs runs
    pitching walks walks
    pitching strikeouts strikeouts
    pitching battingAverageAgainst opponentAverage
    pitching hits hits
    pitching WHIP  
    pitching homeRuns  
    pitching saves  
    pitching holds  
    pitching blownSaves  
    pitching pitches  
    pitching battersFaced  
    pitching battersHit  
    pitching wildPitches  
    pitching balks  
    pitching winPercentage  
    pitching   thirdInnings
    Back to top

    NBA Stats Extension

    NOTE: The stats object and its properties are DEPRECATED. Do not use these objects and properties for new development. Future support is not guaranteed.

    Category Statistics Object Stats Object
    offense gamesPlayed teamGamesPlayed
    offense points points
    offense pointsPerGame  
    offense fieldGoalsMade fieldGoalsMade
    offense fieldGoalsAttempted fieldGoalsAttempted
    offense fieldGoalPercentage fieldGoalPercentage
    offense threePointFieldGoalsMade threePointersMade
    offense threePointFieldGoalsAttempted threePointersAttempted
    offense threePointFieldGoalPercentage threePointPercentage
    offense freeThrowsMade freeThrowsMade
    offense freeThrowsAttempted freeThrowsAttempted
    offense freeThrowPercentage freeThrowPercentage
    offense pointsPerShot  
    offense adjustedFieldGoalPercentage  
    defense gamesPlayed  
    defense opponentPoints  
    defense opponentFieldGoalsMade  
    defense opponentFieldGoalsAttempted  
    defense opponentFieldGoalPercentage  
    defense opponentThreePointFieldGoalsMade  
    defense opponentThreePointFieldGoalsAttempted  
    defense opponentThreePointFieldGoalPercentage  
    defense opponentFreeThrowsMade  
    defense opponentFreeThrowsAttempted  
    defense opponentFreeThrowPercentage  
    defense opponentPointsPerShot  
    defense opponentAdjustedFieldGoalPercentage  
    generalStatistics gamesPlayed  
    generalStatistics offensiveRebounds offensiveRebounds
    generalStatistics opponentOffensiveRebounds  
    generalStatistics defensiveRebounds defensiveRebounds
    generalStatistics opponentDefensiveRebounds  
    generalStatistics rebounds rebounds
    generalStatistics reboundsPerGame  
    generalStatistics opponentRebounds  
    generalStatistics assists assists
    generalStatistics assistsPerGame  
    generalStatistics opponentAssists  
    generalStatistics blocks blocks
    generalStatistics opponentBlocks  
    generalStatistics steals steals
    generalStatistics opponentSteals  
    generalStatistics turnovers turnovers
    generalStatistics opponentTurnovers  
    generalStatistics fouls fouls
    generalStatistics ejections ejections
    Back to top

    NFL Stats Extension

    NOTE: The stats object and its properties are DEPRECATED. Do not use these objects and properties for new development. Future support is not guaranteed.

    Category Statistics Object Stats Object
    offense gamesPlayed  
    offense yards netTotalYards
    offense points totalPoints
    offense firstDowns  
    offense rushingFirstDowns  
    offense passingFirstDowns  
    offense thirdDownConversions  
    offense thirdDownAttempts  
    offense fourthDownConversions  
    offense fourthDownAttempts  
    offense firstDownPenalties  
    offense penalties  
    offense penaltyYards  
    offense yardsPerGame netYardsPerGame
    offense pointsPerGame totalPointsPerGame
    passing gamesPlayed  
    passing passingAttempts  
    passing completions  
    passing completionPercentage  
    passing passingYards netPassingYards
    passing longPassing  
    passing passingTouchdowns  
    passing interceptions  
    passing sacks  
    passing sackedYardsLost  
    passing quarterbackRating  
    rushing gamesPlayed  
    rushing rushingAttempts  
    rushing rushingYards rushingYards
    rushing yardsPerRushAttempt  
    rushing longRushing  
    rushing rushingTouchdowns  
    rushing rushingFumbles  
    rushing rushingFumblesLost  
    receiving gamesPlayed  
    receiving receptions  
    receiving receivingYards  
    receiving longReception  
    receiving receivingTouchdowns  
    receiving receivingFumbles  
    receiving receivingFumblesLost  
    defense gamesPlayed  
    defense totalTackles  
    defense unassistedTackles  
    defense assistedTackles  
    defense sacks  
    defense sackYards  
    defense fumblesRecovered  
    defense passesDefended  
    defense interceptions  
    defense interceptionYards  
    defense longInterception  
    defense interceptionTouchdowns  
    defense fumblesForced  
    defense fumblesRecoveredTouchdowns  
    defense kicksBlocked  
    defense pointsAgainst totalPointsAllowed
    returning gamesPlayed  
    returning kickReturns  
    returning kickReturnYards  
    returning longKickReturn  
    returning kickReturnTouchdowns  
    returning puntReturns  
    returning puntReturnYards  
    returning longPuntReturn  
    returning puntReturnTouchdowns  
    returning puntReturnFairCatches  
    kicking gamesPlayed  
    kicking fieldGoalsMade  
    kicking fieldGoalsAttempted  
    kicking fieldGoalsMade1_19  
    kicking fieldGoalsAttempted1_19  
    kicking fieldGoalsMade20_29  
    kicking fieldGoalsAttempted20_29  
    kicking fieldGoalsMade30_39  
    kicking fieldGoalsAttempted30_39  
    kicking fieldGoalsMade40_49  
    kicking fieldGoalsAttempted40_49  
    kicking fieldGoalsMade50  
    kicking fieldGoalsAttempted50  
    kicking longFieldGoalMade  
    kicking extraPointsMade  
    kicking extraPointsAttempted  
    punting gamesPlayed  
    punting punts  
    punting puntingYards  
    punting longPunt  
    punting grossAveragePuntYards  
    punting netAveragePuntYards  
    punting puntsBlocked  
    punting puntsInside20  
    punting touchbacks  
    punting fairCatches  
    punting puntReturns  
    punting puntReturnYards  
    punting averagePuntReturnYards  
    offense   rushingYardsPerGame
    offense   netPassingYardsPerGame
    defense   netTotalYardsAllowed
    defense   netYardsPerGameAllowed
    defense   rushingYardsAllowed
    defense   rushingYardsPerGameAllowed
    defense   netPassingYardsAllowed
    defense   netPassingYardsPerGameAllowed
    defense   totalPointsPerGameAllowed
    Back to top

     

    NHL Stats Extension

    NOTE: The stats object and its properties are DEPRECATED. Do not use these objects and properties for new development. Future support is not guaranteed.

    Category Statistics Object Stats Object
    offense gamesPlayed teamGames
    offense goals goals
    offense goalsPerGame  
    offense shotsOnGoal totalShots
    offense powerPlayGoals powerGoals
    offense powerPlayOpportunities powerPlayOpportunities
    offense powerPlayPercentage  
    offense shortHandedGoals shortGoals
    offense assists  
    offense points  
    offense penaltyMinutes penaltyMinutes
    offense shootingPercentage  
    offense powerPlayAssists  
    offense shortHandedAssists shutouts
    defense gamesPlayed  
    defense goalsAgainst goalsAgainst
    defense shotsAgainst shotsAgainst
    defense savePercentage  
    defense shortHandedGoalsAgainst shortGoalsAgainst
    defense powerPlayGoalsAgainst powerGoalsAgainst
    defense penaltyKillPercentage  
    defense averageGoalsAgainst  
    defense blockedShots blockedShots
    defense saves  
    defense shutouts  
    majorPenalties gamesPlayed  
    majorPenalties penaltyMinutes  
    majorPenalties majorPenalties  
    majorPenalties misconducts  
    majorPenalties gameMisconducts  
    majorPenalties boardingPenalties  
    majorPenalties unsportsmanlikeConducts  
    majorPenalties fightingPenalties  
    majorPenalties instigatorPenalties  
    majorPenalties timeBetweenFights  
    minorPenalties gamesPlayed  
    minorPenalties penaltyMinutes  
    minorPenalties minorPenalties  
    minorPenalties hookingPenalties  
    minorPenalties trippingPenalties  
    minorPenalties roughingPenalties  
    minorPenalties holdingPenalties  
    minorPenalties interferencePenalties  
    minorPenalties slashingPenalties  
    minorPenalties highStickingPenalties  
    minorPenalties crossCheckingPenalties  
    minorPenalties stickHoldingPenalties  
    minorPenalties goalieInterferencePenalties  
        timesShortHanded
    Back to top

     

    Soccer Stats Extension

    NOTE: The stats object and its properties are DEPRECATED. Do not use these objects and properties for new development. Future support is not guaranteed.

    Category Statistics Object Stats Object
    generalStatistics gamesPlayed gamesPlayed
    generalStatistics wins  
    generalStatistics losses redCards
    generalStatistics draws  
    generalStatistics goalsFor pointsFor
    generalStatistics goalsAgainst pointsAgainst
    generalStatistics goalsDifference  
    generalStatistics goalsForAverage  
    generalStatistics goalsAgainstAverage  
    generalStatistics pointsPerGame  
    generalStatistics points points
    generalStatistics rank rank
        teamDiscipline
        yellowCards
        defenseRank
        shotsFaced
        disciplineRank
        disciplinePoints
        attackRank
        shotsTaken
    Back to top

     

  • Sample Code

    JavaScript
    
    // Example JSONP request with jQuery
    $.ajax({
      url: "http://api.espn.com/v1/sports/baseball/mlb/teams",
      data: {
        // enter your developer api key here
        apikey: "{api key}",
        // the type of data you're expecting back from the api
        _accept: "application/json"
      },
      dataType: "jsonp",
      success: function(data) {
        // create an unordered list of headlines
        var ul = $('<ul/>');
        $.each(data.name, function() {
          var li = $('<li/>').text(this.name);
          ul.append(li)
        });
        // append this list to the document body
        $('body').append(ul);
      },
      error: function() {
         // handle the error
      }
    });