ESPN

ESPN API & Data Access

Unofficial | 👉 Official ESPN Website: http://espn.go.com | 👥 Contributors: steve

Notes

These are unofficial ESPN API endpoints useful for scraping public data such as sporting events, players, scores and more. These endpoints are made available for unofficial use and experimentation, such as for security research, use at your own risk!

These endpoints were uncovered from ESPN’s mobile app using MITM proxy interception, meaning that these endpoints are unlikely to change too much as mobile clients tend to stick around in the wild for a while. Hence, it should be safe to assume these won’t change too much over the next few years.

Rate Limiting

Please be considerate when requesting data through these endpoints or ESPN may block your requesting IP address. We don’t recommend exceeding one request per second per proxy.

Read Only

These endpoints are “read only” and only allow you to scrape data.

Official API

ESPN used to offer an Official API, but has decided to discontinue it.

Sample Data

Below is a sample JSON snippet for a sporting event with scores. You can also download aggregate results together in CSV format.

{
  "sportName": "Golf",
  "type": "ldr",
  "sportUID": "s:1100",
  "leagueUID": "s:1100~l:1106",
  "competitionUID": "s:1100~l:1106~e:401056547~c:401056547",
  "gameId": "401056547",
  "gameState": "in",
  "leagueName": "Men's Golf",
  "eventName": "The Open Championship",
  "gameDate": "2019-07-18T04:00:00Z",
  "dateRange": "Jul 18 - Jul 21",
  "columnHeaders": [...],
  "priority": 0,
  "leagueSortOrder": 0,
  "headline": "",
  "statusText": "Round 2 - In Progress",
  "deepLinkURL": "sportscenter://x-callback-url/showGame?sportName=golf&leagueAbbrev=pga&gameId=401056547",
  "webviewURL": "http://cdn.espn.com/golf/app/gamepage/build?appName=sportscenter&platform=ios&feedVersion=12&sport=pga&id=401056547&locale=us",
  "analytics": {...},
  "header": {...},
  "scoreOneLabel": "Score",
  "scoreTwoLabel": "Today",
  "playerOneName": "Shane Lowry",
  "playerOneRank": 1,
  "playerOneScoreOneValue": "-10",
  "playerOneScoreTwoValue": "-6(10)",
  "playerTwoName": "J.B. Holmes",
  "playerTwoRank": 2,
  "playerTwoScoreOneValue": "-8",
  "playerTwoScoreTwoValue": "-3(F)",
  "playerThreeName": "Tommy Fleetwood",
  "playerThreeRank": 3,
  "playerThreeScoreOneValue": "-7",
  "playerThreeScoreTwoValue": "-4(F)",
  "playerFourName": "Lee Westwood",
  "playerFourRank": 3,
  "playerFourScoreOneValue": "-7",
  "playerFourScoreTwoValue": "-4(F)",
  "playerFiveName": "Cameron Smith",
  "playerFiveRank": 5,
  "playerFiveScoreOneValue": "-6",
  "playerFiveScoreTwoValue": "-5(F)",
  "playerOneLogoURL": "https://secure.espncdn.com/i/teamlogos/countries/500/irl.png",
  "playerTwoLogoURL": "https://secure.espncdn.com/i/teamlogos/countries/500/usa.png",
  "playerThreeLogoURL": "https://secure.espncdn.com/i/teamlogos/countries/500/eng.png",
  "playerFourLogoURL": "https://secure.espncdn.com/i/teamlogos/countries/500/eng.png",
  "playerFiveLogoURL": "https://secure.espncdn.com/i/teamlogos/countries/500/aus.png",
  "detailTextOne": "Round 2 - In Progress",
  "detailTextTwo": "Royal Portrush Golf Club - Portrush",
  "detailTextThree": "Purse: $10,750,000.00"
}

Articles