ESPN.com Scraper

The actor scrapes match results and articles from ESPN.com for hockey, baseball, and basketball.

Features

  • Scraping all match results for NBA, NHL, MLB, NFL and college basketball
  • Scraping detailed match data for NBA, NHL, MLB and college basketball
  • Scraping articles for NBA, NHL, MLB, NFL and college basketball

Cost of usage

You can get up to 50 000 results for 1 USD. Result count per 1 USD varies according to the type of scraped data and according to the scraped league.

Input parameters

  • scrapeMatchList - if true, the actor will scrape match results according to other inputs
  • matchListYears - array of years, for which the actor should scrape the match results
  • matchListSeasonTypes - type of season, for which the actor should scrape the match results
    • Allowed values:
    • pre - Pre-season
    • reg - Regular season
    • post - Post-season/Play-off
    • off - Off-season
  • matchListLeagues - leagues, for which the actor should scrape the match results
    • Allowed values: mlb, nhl, nba, wnba, nfl, mens-college-basketball, womens-college-basketball
  • scrapeMatchDetails - if true, actor will scrape detail data for specified matches
  • detailMatches - Array of matches, for which the actor should scrape the detailed results
  • matchDetailsLeague - League of match/matches
    • Allowed values: mlb, nhl, nba, wnba, nfl, mens-college-basketball, womens-college-basketball
  • scrapeNews - if true, the actor will scrape articles from the news feed of a given league
  • newsLeague - league, for which actor should scrape the articles
    • Allowed values: mlb, nhl, nba, wnba, nfl, mens-college-basketball, womens-college-basketball
  • debug - if true, actor will print out additional information

Input example

{ "debug": false, "scrapeMatchList": true, "matchListYears": ["2019"], "matchListSeasonTypes": ["reg"], "matchListLeagues": ["nba"], "scrapeMatchDetails": true, "detailMatches": ["https://www.espn.com/nba/game/_/gameId/401360779"], "matchDetailsLeague": "nba", "scrapeNews": true, "newsLeague": "nhl" }

Output examples

Match list

{ "resultType": "matchList", "id": "401070217", "date": "2018-10-19T00:00Z", "venue": { "capacity": 21000, "fullName": "Wells Fargo Center", "city": "Philadelphia", "state": "PA" }, "competitors": [ { "id": "20", "winner": true, "displayName": "Philadelphia 76ers", "abbreviation": "PHI", "home": true, "score": 127 }, { "id": "4", "winner": false, "displayName": "Chicago Bulls", "abbreviation": "CHI", "home": false, "score": 108 } ], "headlines": [ { "long": "Ben Simmons had a triple-double with 13 points, 13 rebounds and 11 assists and Joel Embiid had 30 points and 12 rebounds to lead the Philadelphia 76ers past the Chicago Bulls 127-108 on Thursday night.", "short": "Simmons triple-double leads 76ers past Bulls 127-108" } ], "attendance": 20302, "winnerAbbreviation": "PHI", "sport": "basketball", "league": "nba", "season": 2019, "seasonType": "reg", "url": "https://site.web.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard?dates=20181018" }

Match detail

Base information

{ "resultType": "matchDetail", "id": "401360779", "date": "2022-03-06T18:00Z", "venue": { "capacity": 19156, "fullName": "TD Garden", "city": "Boston", "state": "MA" }, "competitors": [ { "id": "2", "winner": true, "displayName": "Boston Celtics", "abbreviation": "BOS", "home": true, "score": 126 }, { "id": "17", "winner": false, "displayName": "Brooklyn Nets", "abbreviation": "BKN", "home": false, "score": 120 } ], "headlines": [], "attendance": 19156, "winnerAbbreviation": "BOS", "officials": [ "Zach Zarba", "Kevin Cutler", "Nick Buchert" ], "sport": "basketball", "league": "nba" }

Basketball

All base information + basketball specific information

{ "players": [ { "id": "3202", "stats": { "MIN": "39", "FG": "12-21", "3PT": "4-9", "FT": "9-10", "OREB": "1", "DREB": "5", "REB": "6", "AST": "8", "STL": "1", "BLK": "2", "TO": "7", "PF": "2", "+/-": "-3", "PTS": "37" }, "team": "BKN", "position": "PF", "name": "Kevin Durant" } ], "scoring": [ { "id": "40136077918", "homeScore": 2, "awayScore": 4, "scored": true, "description": "Kevin Durant makes 15-foot pullup jump shot", "type": "2-pointer", "player": { "id": "3202", "name": "Kevin Durant", "team": "BKN" }, "timeInSeconds": 96 } ] }

Hockey

All base information + hockey specific information

{ "players": [ { "id": "2976844", "stats": { "+/-": "0", "TOI": "30:22", "PPTOI": "5:47", "SHTOI": "1:36", "ESTOI": "22:59", "SHFT": "38", "G": "1", "YTDG": "6", "A": "1", "S": "5", "SM": "1", "SOG": "0", "FW": "18", "FL": "16", "FO%": "52.9", "GV": "2", "BS": "1", "HT": "1", "TK": "2", "PN": "0", "PIM": "0" }, "team": "SJ", "position": "C", "name": "Tomas Hertl" }, { "id": "5096", "stats": { "TOI": "78:10", "YTDG": "0", "GA": "4", "SA": "38", "SOS": "0", "SOSA": "0", "SV": "34", "SV%": ".895", "ESSV": "30", "PPSV": "2", "SHSV": "2", "PIM": "0" }, "team": "SJ", "position": "G", "name": "Martin Jones" } ], "shooting": [ { "id": "40112633929385", "homeScore": 5, "awayScore": 4, "scored": true, "team": "SJ", "shooter": { "id": "3069411", "name": "Barclay Goodrow" }, "assists": [ { "id": "2324313", "name": "Erik Karlsson" }, { "id": "4063462", "name": "Marcus Sorensen" } ], "timeInSeconds": 4699, "description": "Even Strength Goal Scored by Barclay Goodrow assisted by Erik Karlsson and Marcus Sorensen" } ], "penalties": [ { "id": "40112633929195", "team": "VGK", "punishedPlayer": { "id": "5237", "name": "Cody Eakin" }, "timeInSeconds": 2953, "lengthInMinutes": 5, "description": "Penalty to Cody Eakin 5 minutes for Cross checking (Major) (served by Ryan Reaves)" } ] }

Baseball

All base information + baseball specific information

{ "players": [ { "id": "32129", "stats": { "H-AB": "1-4", "AB": "4", "R": "1", "H": "1", "RBI": "0", "HR": "0", "BB": "0", "K": "0", "#P": "15", "AVG": ".275", "OBP": ".346", "SLG": ".456" }, "team": "NYM", "statType": "batting", "position": "SS", "name": "Francisco Lindor" }, { "id": "28968", "stats": { "IP": "3.0", "H": "6", "R": "4", "ER": "4", "BB": "1", "K": "2", "HR": "1", "PC-ST": "67-41", "ERA": "3.95", "PC": "67" }, "team": "NYM", "statType": "pitching", "position": "SP", "name": "Carlos Carrasco" } ], "atBats": [ { "id": "4013565060403", "homeScore": 0, "awayScore": 4, "description": "Bleday homered to right (339 feet), De La Cruz scored.", "balls": 2, "strikes": 1, "outcome": "home-run", "pitches": [ { "pitchType": "FF", "strike": true, "outcome": "foul-ball" }, { "pitchType": "FF", "strike": false, "outcome": "ball" }, { "pitchType": "CH", "strike": false, "outcome": "ball" }, { "pitchType": "FF", "strike": false, "outcome": "home-run" } ], "pitcher": { "id": "28968", "name": "Carlos Carrasco", "team": "NYM" }, "batter": { "id": "28968", "name": "JJ Bleday", "team": "MIA" } }, { "id": "4013565060404", "homeScore": 0, "awayScore": 4, "description": "Stallings popped out to second.", "balls": 0, "strikes": 0, "outcome": "pop-out", "pitches": [ { "pitchType": "FF", "strike": false, "outcome": "pop-out" } ], "pitcher": { "id": "28968", "name": "Carlos Carrasco", "team": "NYM" }, "batter": { "id": "28968", "name": "Jacob Stallings", "team": "MIA" } } ] }

Articles

{ "resultType": "article", "league": "nhl", "title": "Chicago Blackhawks' Patrick Kane: Trade rumors are just rumors", "description": "Patrick Kane thinks rumors of him being traded by the rebuilding Blackhawks are just rumors.", "content": "<p><a href=\"http://www.espn.com/nhl/player/_/id/3735/patrick-kane\">Patrick Kane</a> is well aware he has been the subject of rampant trade speculation for months ...", "url": "https://www.espn.com/nhl/story/_/id/34643731/chicago-blackhawks-patrick-kane-trade-rumors-just-rumors", "imageUrl": "https://a.espncdn.com/photo/2019/0221/r504970_600x400_3-2.jpg", "publishedAt": "2022-09-23T11:11:00Z" }