ESPN.com Scraper

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
  • Allowed formats:
  • ID: e.g.: 401126339
  • URL of match detail e.g.: https://www.espn.com/nhl/game/\_/gameId/401126339
• 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

1{
2    "debug": false,
3    "scrapeMatchList": true,
4    "matchListYears": ["2019"],
5    "matchListSeasonTypes": ["reg"],
6    "matchListLeagues": ["nba"],
7    "scrapeMatchDetails": true,
8    "detailMatches": ["https://www.espn.com/nba/game/_/gameId/401360779"],
9    "matchDetailsLeague": "nba",
10    "scrapeNews": true,
11    "newsLeague": "nhl"
12}

Output examples

Match list

1{
2	"resultType": "matchList",
3	"id": "401070217",
4	"date": "2018-10-19T00:00Z",
5	"venue": {
6		"capacity": 21000,
7		"fullName": "Wells Fargo Center",
8		"city": "Philadelphia",
9		"state": "PA"
10	},
11	"competitors": [
12		{
13			"id": "20",
14			"winner": true,
15			"displayName": "Philadelphia 76ers",
16			"abbreviation": "PHI",
17			"home": true,
18			"score": 127
19		},
20		{
21			"id": "4",
22			"winner": false,
23			"displayName": "Chicago Bulls",
24			"abbreviation": "CHI",
25			"home": false,
26			"score": 108
27		}
28	],
29	"headlines": [
30		{
31			"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.",
32			"short": "Simmons triple-double leads 76ers past Bulls 127-108"
33		}
34	],
35	"attendance": 20302,
36	"winnerAbbreviation": "PHI",
37	"sport": "basketball",
38	"league": "nba",
39	"season": 2019,
40	"seasonType": "reg",
41	"url": "https://site.web.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard?dates=20181018"
42}

Match detail

Base information

1{
2	"resultType": "matchDetail",
3	"id": "401360779",
4	"date": "2022-03-06T18:00Z",
5	"venue": {
6		"capacity": 19156,
7		"fullName": "TD Garden",
8		"city": "Boston",
9		"state": "MA"
10	},
11	"competitors": [
12		{
13			"id": "2",
14			"winner": true,
15			"displayName": "Boston Celtics",
16			"abbreviation": "BOS",
17			"home": true,
18			"score": 126
19		},
20		{
21			"id": "17",
22			"winner": false,
23			"displayName": "Brooklyn Nets",
24			"abbreviation": "BKN",
25			"home": false,
26			"score": 120
27		}
28	],
29	"headlines": [],
30	"attendance": 19156,
31	"winnerAbbreviation": "BOS",
32	"officials": [
33		"Zach Zarba",
34		"Kevin Cutler",
35		"Nick Buchert"
36	],
37    "sport": "basketball",
38    "league": "nba"
39}

Basketball

All base information + basketball specific information

1{
2	"players": [
3		{
4			"id": "3202",
5			"stats": {
6				"MIN": "39",
7				"FG": "12-21",
8				"3PT": "4-9",
9				"FT": "9-10",
10				"OREB": "1",
11				"DREB": "5",
12				"REB": "6",
13				"AST": "8",
14				"STL": "1",
15				"BLK": "2",
16				"TO": "7",
17				"PF": "2",
18				"+/-": "-3",
19				"PTS": "37"
20			},
21			"team": "BKN",
22			"position": "PF",
23			"name": "Kevin Durant"
24		}
25	],
26	"scoring": [
27		{
28			"id": "40136077918",
29			"homeScore": 2,
30			"awayScore": 4,
31			"scored": true,
32			"description": "Kevin Durant makes 15-foot pullup jump shot",
33			"type": "2-pointer",
34			"player": {
35				"id": "3202",
36				"name": "Kevin Durant",
37				"team": "BKN"
38			},
39			"timeInSeconds": 96
40		}
41	]
42}

Hockey

All base information + hockey specific information

1{
2	"players": [
3		{
4			"id": "2976844",
5			"stats": {
6				"+/-": "0",
7				"TOI": "30:22",
8				"PPTOI": "5:47",
9				"SHTOI": "1:36",
10				"ESTOI": "22:59",
11				"SHFT": "38",
12				"G": "1",
13				"YTDG": "6",
14				"A": "1",
15				"S": "5",
16				"SM": "1",
17				"SOG": "0",
18				"FW": "18",
19				"FL": "16",
20				"FO%": "52.9",
21				"GV": "2",
22				"BS": "1",
23				"HT": "1",
24				"TK": "2",
25				"PN": "0",
26				"PIM": "0"
27			},
28			"team": "SJ",
29			"position": "C",
30			"name": "Tomas Hertl"
31		},
32		{
33			"id": "5096",
34			"stats": {
35				"TOI": "78:10",
36				"YTDG": "0",
37				"GA": "4",
38				"SA": "38",
39				"SOS": "0",
40				"SOSA": "0",
41				"SV": "34",
42				"SV%": ".895",
43				"ESSV": "30",
44				"PPSV": "2",
45				"SHSV": "2",
46				"PIM": "0"
47			},
48			"team": "SJ",
49			"position": "G",
50			"name": "Martin Jones"
51		}
52	],
53	"shooting": [
54		{
55			"id": "40112633929385",
56			"homeScore": 5,
57			"awayScore": 4,
58			"scored": true,
59			"team": "SJ",
60			"shooter": {
61				"id": "3069411",
62				"name": "Barclay Goodrow"
63			},
64			"assists": [
65				{
66					"id": "2324313",
67					"name": "Erik Karlsson"
68				},
69				{
70					"id": "4063462",
71					"name": "Marcus Sorensen"
72				}
73			],
74			"timeInSeconds": 4699,
75			"description": "Even Strength Goal Scored by Barclay Goodrow assisted by Erik Karlsson and Marcus Sorensen"
76		}
77	],
78	"penalties": [
79		{
80			"id": "40112633929195",
81			"team": "VGK",
82			"punishedPlayer": {
83				"id": "5237",
84				"name": "Cody Eakin"
85			},
86			"timeInSeconds": 2953,
87			"lengthInMinutes": 5,
88			"description": "Penalty to Cody Eakin 5  minutes for Cross checking (Major) (served by Ryan Reaves)"
89		}
90	]
91}

Baseball

All base information + baseball specific information

1{
2	"players": [
3		{
4			"id": "32129",
5			"stats": {
6				"H-AB": "1-4",
7				"AB": "4",
8				"R": "1",
9				"H": "1",
10				"RBI": "0",
11				"HR": "0",
12				"BB": "0",
13				"K": "0",
14				"#P": "15",
15				"AVG": ".275",
16				"OBP": ".346",
17				"SLG": ".456"
18			},
19			"team": "NYM",
20			"statType": "batting",
21			"position": "SS",
22			"name": "Francisco Lindor"
23		},
24		{
25			"id": "28968",
26			"stats": {
27				"IP": "3.0",
28				"H": "6",
29				"R": "4",
30				"ER": "4",
31				"BB": "1",
32				"K": "2",
33				"HR": "1",
34				"PC-ST": "67-41",
35				"ERA": "3.95",
36				"PC": "67"
37			},
38			"team": "NYM",
39			"statType": "pitching",
40			"position": "SP",
41			"name": "Carlos Carrasco"
42		}
43	],
44	"atBats": [
45		{
46			"id": "4013565060403",
47			"homeScore": 0,
48			"awayScore": 4,
49			"description": "Bleday homered to right (339 feet), De La Cruz scored.",
50			"balls": 2,
51			"strikes": 1,
52			"outcome": "home-run",
53			"pitches": [
54				{
55					"pitchType": "FF",
56					"strike": true,
57					"outcome": "foul-ball"
58				},
59				{
60					"pitchType": "FF",
61					"strike": false,
62					"outcome": "ball"
63				},
64				{
65					"pitchType": "CH",
66					"strike": false,
67					"outcome": "ball"
68				},
69				{
70					"pitchType": "FF",
71					"strike": false,
72					"outcome": "home-run"
73				}
74			],
75			"pitcher": {
76				"id": "28968",
77				"name": "Carlos Carrasco",
78				"team": "NYM"
79			},
80			"batter": {
81				"id": "28968",
82				"name": "JJ Bleday",
83				"team": "MIA"
84			}
85		},
86		{
87			"id": "4013565060404",
88			"homeScore": 0,
89			"awayScore": 4,
90			"description": "Stallings popped out to second.",
91			"balls": 0,
92			"strikes": 0,
93			"outcome": "pop-out",
94			"pitches": [
95				{
96					"pitchType": "FF",
97					"strike": false,
98					"outcome": "pop-out"
99				}
100			],
101			"pitcher": {
102				"id": "28968",
103				"name": "Carlos Carrasco",
104				"team": "NYM"
105			},
106			"batter": {
107				"id": "28968",
108				"name": "Jacob Stallings",
109				"team": "MIA"
110			}
111		}
112	]
113}

Articles

1{
2	"resultType": "article",
3	"league": "nhl",
4	"title": "Chicago Blackhawks' Patrick Kane: Trade rumors are just rumors",
5	"description": "Patrick Kane thinks rumors of him being traded by the rebuilding Blackhawks are just rumors.",
6	"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 ...",
7    "url": "https://www.espn.com/nhl/story/_/id/34643731/chicago-blackhawks-patrick-kane-trade-rumors-just-rumors",
8	"imageUrl": "https://a.espncdn.com/photo/2019/0221/r504970_600x400_3-2.jpg",
9	"publishedAt": "2022-09-23T11:11:00Z"
10}