ESPN Standings Data

Standings beta

Where feeds never settle for 2nd best

  • The ESPN Standings API enables you to get the latest standings for a particular sport by division, conference, or overall. Data is also available by year and by season type (preseason, regular season, playoffs).

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

    Availability
    Public Partner Premium Partner ESPN

    This API is great for:

    • Standings/tables applications
    • Working with team win/loss statistics
    • Predicting playoff probability for teams
    • Comparing teams

  • The ESPN Standings API accepts a GET request.

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

    Sample Standings Requests

    Action URI Description
    GET http://api.espn.com/v1/sports/baseball/mlb/standings Latest standings for Major League Baseball, grouped by division.
    GET http://api.espn.com/v1/sports/baseball/mlb/standings?lang=es Latest standings for Major League Baseball, grouped by division, with optional Spanish-language translations enabled.
    GET http://api.espn.com/v1/sports/baseball/mlb/standings?dates=2009 MLB standings for a particular season.
    GET http://api.espn.com/v1/sports/baseball/mlb/standings?groups=2 Standings for the American League East division in MLB for the current season.
    GET http://api.espn.com/v1/sports/baseball/mlb/standings?groups=2&dates=2010 Standings for the American League East division in MLB in the 2010 season.
    GET http://api.espn.com/v1/sports/baseball/mlb/standings?seasontype=3 Returns postseason standings for all MLB teams playing in the playoffs.
  • Quick Navigation

    Resources

    Resource Name Description Availability
    public partner premium
    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 (WNBA)
    /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/golf/pga Professional Golfers' Association (PGA) golf
    /sports/hockey/nhl National Hockey League (NHL)
    /sports/racing/f1 Formula 1 Racing
    /sports/racing/irl IndyCar Series Racing
    /sports/racing/sprint NASCAR Sprint Racing
    /sports/racing/truck NASCAR Truck Racing
    /sports/soccer/:leagueAbbrev Specific professional soccer league.
    Use a helper API call for a complete list of supported soccer leagues.
    /sports/tennis/atp Association of Tennis Professionals
    /sports/tennis/wta Women's Tennis Association
    Back to top

     

    Methods

    Method Description Availability
    public partner premium
    partner    		 espn
    /standings Retrieves a list of ranked competitors with corresponding API links.
    Back to top

     

    URI Parameters

    Method Description Availability
    public partner premium
    partner    		 espn
    enable Optional flag to enable specific information, with the following options. Accepts a single value or a comma delimited string of values (i.e. enable=a,b,c).
    logos Enables team logos.
    dates Integer in the form of yyyy to limit output to a particular season. If not explicitly passed will default to the current season and season type (pre/reg/post) corresponding to the current date. 
    seasontype Value corresponding to either preseason, regular season, or postseason games. Accepts string (pre/reg/post) values. If not explicitly passed will default to the season type corresponding to the current date. This parameter is not applicable to golf, tennis, or racing.
    flat Boolean (default is false) - Returns a flattened result set in order to show all teams ranked from first to last without breaking them out into divisions. Only valid with team-based sports.
    groups Integer - Allows for filtering by "group" or division, e.g. AL East, NFC South, etc. For group IDs and their corresponding values, make a request to http://developer.espn.com/v1/:sportname/:leaguename/groups. Not applicable to golf and tennis.
    type String - allows further refinement in a specific sport. Possible values are as follows per sport:
    mlb wildcard
    racing points / poles / top10s / top5s / money / wins / cars
    golf points / money / wins / top10s
    tennis race / rank / money
    lang Can be used to return content in the specified language. Supported languages are below. Note: not all content is available in multiple languages and will return in English if no alternative is available.
    en English. Default language.
    es Spanish
    Back to top

     

  • Quick Navigation

    Returned Data

    Element Description Availability
    public partner premium
    partner    		 espn
    sports A collection of sports associated with the request, e.g. "baseball." Contains a leagues collection and also has the following properties:
    name The name of the sport, e.g. "Baseball."
    id the ID of the sport in the ESPN API.
    type String - the type of standings view for the current request. Defaults to "points" for a standard standings view. Additional standings types vary by sport and are documented in the URI parameters documented for this API.
    leagues Collection within 'sports' that contains a 'group' collection and also the following properties:
    id the ID of the sport in ESPN's meta-tagging system.
    groupId The ID, unique to the selected organizing body, of the conference/division being used.
    name the name of the league/conference/division, e.g. "American League East."
    shortName Shorter version of the name of the league/conference/division.
    abbreviation the abbreviation for the league/conference/division, e.g. "al" for "American League."
    groups Collection of group objects within 'leagues'. May also contain child groups of the same type. Contains a collection of 'competitors'. Also contains all the properties below:
    id the id corresponding to the league/conference/division.
    name the name of the league/conference/division, e.g. "American League West."
    abbreviation the abbreviation for the league/conference/division, e.g. "alw" for "American League West."
    competitors Collection of teams or athletes (depending on sport) within the 'group' collection. Contains the following properties:
    id The team's ID within that sport.
    location The team's location, e.g. "New York."
    name The team's nickname, e.g. "Yankees."
    abbreviation The team's abbreviation, e.g. "nyy."
    logos Collection of team logos as specified below, each containing href, width, and height attributes:
    large 110x110 team logo
    medium 80x80 team logo
    small 50x50 team logo
    xsmall 40x40 team logo
    xxsmall 25x25 team logo
    record A collection within the competitor object with record summary, season info, and stats views for different splits, including season, conference, division, home, away, and stats. Details of each record object are below.
    season Object containing the following properties:
    year - the calendar year in which the majority of the sport's season is played.
    type - Integer corresponding to the season type (1 = preseason, 2 = regular season, 3 = postseason).
    description - String representation of the season type (e.g. "regular" for season type = 2).
    startDate - date for which the season starts for this sport/league.
    endDate - date for which the season ends for this sport/league.
    summary A string representation of the team's record, e.g. "75-42".
    wins Wins for the season specified.
    losses Losses for the season specified.
    ties Ties for the season specified (where applicable).
    overTimeLosses Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
    winPercentage Win percentage based on wins/losses.
    conference Object within the 'record' object containing statistics for team against conference opponents during the selected season (default is current year).
    summary - A string representation of the team's record, e.g. "75-42".
    wins - Wins for the season specified.
    losses - Losses for the season specified.
    ties - Ties for the season specified (where applicable).
    overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
    winPercentage - Win percentage based on wins/losses.
    division Object within the 'record' object containing statistics for team against division opponents during the selected season (default is current year).
    summary - A string representation of the team's record, e.g. "75-42".
    wins - Wins for the season specified.
    losses - Losses for the season specified.
    ties - Ties for the season specified (where applicable).
    overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
    winPercentage - Win percentage based on wins/losses.
    home Object within the 'record' object containing statistics for team when the team is playing at home during the selected season (default is current year).
    summary - A string representation of the team's record, e.g. "75-42".
    wins - Wins for the season specified.
    losses - Losses for the season specified.
    ties - Ties for the season specified (where applicable).
    overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
    winPercentage - Win percentage based on wins/losses.
    away Object within the 'record' object containing statistics for team when the team is playing on the road during the selected season (default is current year).
    summary - A string representation of the team's record, e.g. "75-42".
    wins - Wins for the season specified.
    losses - Losses for the season specified.
    ties - Ties for the season specified (where applicable).
    overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
    winPercentage - Win percentage based on wins/losses.
    stats When enabled, returns an object within the 'competitor' object of additional statistics as shown below:
    streak Positive or negative number representing the number of consecutive wins or losses.
    gamesPlayed Total games played.
    points
    pointsAgainstTotal Total points scored against the team.
    pointsAgainstAverage Avg. points scored against the team per game/match.
    pointsForTotal Total points scored.
    pointsForAverage Total points score per game/match.
    playoffSeed The team's current position (seed) if the playoffs began today. Not applicable to all sports.
    gamesBehind Games behind first place team.
    links Collection of relevant API endpoints and canonical URLs for the team.
    Back to top

     

    Sample Response

    XML

    The following XML output was rendered with an internal key calling:
    http://api.espn.com/v1/sports/basketball/nba/standings?seasontype=2&_accept=text/xml&apikey=:yourkey.

     

    JSON

    The following JSON output was rendered with an internal key calling:
    http://api.espn.com/v1/sports/basketball/nba/standings?seasontype=2&apikey=:yourkey.

    Back to top

  • Sample Code

    Coming soon.

Browse Other Data

Additional Help

version 64 as of 2 months ago by Chris Jason