Skip to content

ESPN API

ESPN (espn.com) has 5 public methods: get scores, get team schedule, get player stats, list news for a league or team and get game summary. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

espn.com (opens in a new tab)

Unofficial. Not affiliated with or endorsed by ESPN.

Methods

5

  • Get scores

    Gets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone.

    Returns teams, scores, status, period, clock, start time, TV, venue, top performers, game link

    Readespn.com/get_scores

  • Get team schedule

    Returns a team's past results and upcoming games for a season on ESPN, with opponents, local start times, scores, broadcasts and venues. Soccer fixtures include all competitions shown for the team.

    Returns team, league, season, team link, and games with date_time, opponent, home_away, result, score, tv_network, venue, game_link, event_id

    Readespn.com/get_team_schedule

  • Get player stats

    Looks up an ESPN player by name and returns season and career statistics. Use a league to tell apart players with the same name, and a season year or label to pick a past season.

    Returns player profile, season and career stats

    Readespn.com/get_player_stats

  • List news for a league or team

    Finds an ESPN league or team by name and lists the latest headlines ESPN publishes for it, newest first.

    Returns headline, summary, published time, author, image link, article link

    Readespn.com/list_news

  • Get game summary

    Finds the latest game between two teams, or their game on a given date, in major US leagues, MLS or the EPL. Returns the score, scoring by period, leading players, team stats and player box scores.

    Returns league, date/time, status, venue, attendance, score, period scoring, top performers, team stats, player box score, game link

    Readespn.com/get_game_summary