MLB Scraper

Pull Major League Baseball data at scale — game schedules and scores, all 30 clubs, active rosters, player bios with season hitting and pitching stats, and division, league, and wild-card standings. One structured input picks between five data types, and you name teams and players in plain English — no numeric IDs to look up. Built for sports analysts, fantasy-baseball tools, betting modelers, and journalists who need clean, structured MLB data without wrangling the official stats API by hand.

Why This Scraper?

• Five data types in one actor — games, teams, rosters, players, and standings, switched with a single dropdown. Most MLB scrapers skip standings entirely.
• All 30 MLB clubs across the AL and NL — full name, abbreviation, league, division, home venue, and first year of play for every franchise.
• Season hitting and pitching stats — HR, AVG, OBP, SLG, OPS, RBI, ERA, and the full stat block per player, grouped into hitting, pitching, and fielding.
• Six game types including the World Series and Spring Training — filter to Regular Season, Wild Card, Division Series, League Championship, World Series, or Spring Training.
• Four standings views including the wild-card race — by division, by league, wild card, or wild card with division leaders, each with games back and wild-card games back.
• Name teams and players in plain English — "New York Yankees", "NYY", "Shohei Ohtani", or a mlb.com URL all resolve automatically; no need to know that 147 is the Yankees or 660271 is Ohtani.
• Box-score-grade game data — final scores, linescore runs/hits/errors, winning/losing/save pitchers, venue, series description, and day/night flag on every game row.
• Any season the official record covers — pick any year from 1876 to the current season for games, rosters, players, and standings.

Use Cases

Sports Analytics

• Track team win percentage, run differential, and streaks across a season
• Compare hitting and pitching production between players and clubs
• Build historical performance datasets across multiple seasons
• Monitor division and wild-card races as standings shift

Fantasy Baseball

• Pull season stat lines for every player on a roster to power draft rankings
• Refresh active rosters to catch call-ups, trades, and IL moves
• Score players on HR, RBI, OBP, SLG, ERA, and other category leaders
• Map jersey numbers, positions, and status for lineup tools

Betting Models

• Feed final scores and run totals into predictive models
• Analyze head-to-head matchups by team, venue, and game type
• Isolate postseason performance with World Series and Division Series filters
• Track streaks and games back to gauge momentum

Journalism & Media

• Auto-build box-score summaries and standings tables for coverage
• Pull player bios — birthplace, debut date, height, weight, bats/throws
• Generate wild-card race snapshots on demand
• Verify schedules and results against the official record

Research & Data Products

• Assemble multi-season baseball datasets for study
• Power dashboards with structured team, player, and standings feeds
• Enrich existing rosters with current-season stat lines
• Archive full-season schedules with scores and outcomes

Getting Started

Today's Games

The simplest run — leave the dates blank to get today's schedule with scores:

{
    "dataType": "games"
}

A Team's Roster with Season Stats

{
    "dataType": "rosters",
    "teams": ["Los Angeles Dodgers"],
    "season": 2025,
    "includeStats": true
}

Wild-Card Standings

{
    "dataType": "standings",
    "standingsType": "wildCard",
    "season": 2025
}

Player Bios and Stats

{
    "dataType": "players",
    "players": ["Shohei Ohtani", "Aaron Judge"],
    "season": 2025,
    "includeStats": true
}

World Series Games in a Date Range

{
    "dataType": "games",
    "season": 2024,
    "startDate": "2024-10-25",
    "endDate": "2024-10-31",
    "gameType": "W"
}

Input Reference

What to Extract

Parameter	Type	Default	Description
dataType	select	Games — schedules, scores & matchups	Choose the kind of MLB data: Games, Teams, Rosters, Players, or Standings.

Filters

Parameter	Type	Default	Description
teams	string[]	["New York Yankees"]	Team names (e.g. "New York Yankees"), abbreviations (e.g. "NYY"), team IDs, or mlb.com team links. Picks which teams' rosters to fetch and narrows games and standings. Leave empty for all 30 teams.
players	string[]	[]	Player names (e.g. "Shohei Ohtani"), player IDs, or mlb.com player links. Applies to the Players data type.
season	integer	2026	The season year to collect, e.g. 2025. Applies to all data types.
startDate	string	""	Collect games on or after this date (YYYY-MM-DD). Leave empty to use today. Games only.
endDate	string	""	Collect games on or before this date (YYYY-MM-DD). Leave empty to match the start date. Games only.
gameType	select	All game types	Limit to one game type: Regular Season, Wild Card, Division Series, League Championship, World Series, or Spring Training. Applies to Games.
standingsType	select	Division standings	How to group standings: Division standings, League standings, Wild Card standings, or Wild Card with division leaders. Standings only.

Output Detail

Parameter	Type	Default	Description
includeStats	boolean	true	For Rosters and Players, also fetch each player's season stats. Turn off for faster, cheaper runs that return only roster and bio information. No effect on Games, Teams, or Standings.

Limits

Parameter	Type	Default	Description
maxResults	integer	100	How many records to collect in total. Set to 0 to collect as many as possible. Standings and Teams always return their full fixed set.

Output

Each row carries a recordType field identifying which of the five data types it is. Examples and field tables for each type follow.

Games (recordType: "game")

{
    "recordType": "game",
    "gamePk": 775296,
    "gameDate": "2024-10-30T00:08:00Z",
    "officialDate": "2024-10-30",
    "gameType": "World Series",
    "season": 2024,
    "status": "Final",
    "seriesDescription": "World Series",
    "homeTeam": {
        "id": 147,
        "name": "New York Yankees",
        "abbreviation": "NYY",
        "score": 5,
        "isWinner": false,
        "leagueRecord": { "wins": 1, "losses": 4, "pct": ".200" }
    },
    "awayTeam": {
        "id": 119,
        "name": "Los Angeles Dodgers",
        "abbreviation": "LAD",
        "score": 7,
        "isWinner": true,
        "leagueRecord": { "wins": 4, "losses": 1, "pct": ".800" }
    },
    "venue": { "id": 3313, "name": "Yankee Stadium" },
    "dayNight": "night",
    "doubleHeader": "N",
    "scheduledInnings": 9,
    "linescore": { "currentInning": 9, "teams": { "home": { "runs": 5, "hits": 8, "errors": 0 }, "away": { "runs": 7, "hits": 9, "errors": 1 } } },
    "decisions": { "winner": { "id": 621111, "fullName": "Walker Buehler" }, "loser": { "id": 543037, "fullName": "Gerrit Cole" } },
    "url": "https://www.mlb.com/gameday/775296",
    "scrapedAt": "2026-07-01T14:30:00Z"
}

Field	Type	Description
recordType	string	Always "game"
gamePk	integer	Unique game identifier
gameDate	string	Game start time (UTC)
officialDate	string	Calendar date (YYYY-MM-DD)
gameType	string	Full label, e.g. "Regular Season", "World Series"
season	integer	Season year
status	string	Game status, e.g. Final, Scheduled, In Progress
seriesDescription	string	Series name, e.g. "Regular Season", "World Series"
homeTeam / awayTeam	object	Team id, name, abbreviation, score, isWinner, and league record
venue	object	Ballpark id and name
dayNight	string	"day" or "night"
doubleHeader	string	Doubleheader flag: N (none), Y (traditional), or S (split)
scheduledInnings	integer	Scheduled innings, usually 9
linescore	object	Current inning and per-team runs, hits, and errors
decisions	object	Winning, losing, and save pitchers
url	string	mlb.com Gameday link
scrapedAt	string	Extraction timestamp

Teams (recordType: "team")

{
    "recordType": "team",
    "id": 147,
    "name": "New York Yankees",
    "abbreviation": "NYY",
    "teamCode": "nya",
    "fileCode": "nyy",
    "league": { "id": 103, "name": "American League" },
    "division": { "id": 201, "name": "American League East" },
    "venue": { "id": 3313, "name": "Yankee Stadium" },
    "firstYearOfPlay": "1903",
    "locationName": "Bronx",
    "url": "https://www.mlb.com/team/147",
    "scrapedAt": "2026-07-01T14:30:00Z"
}

Field	Type	Description
recordType	string	Always "team"
id	integer	Team identifier
name	string	Full club name
abbreviation	string	Short code, e.g. NYY
teamCode / fileCode	string	Internal team codes
league	object	League id and name (AL or NL)
division	object	Division id and name
venue	object	Home ballpark id and name
firstYearOfPlay	string	First year the franchise played
locationName	string	Home city or borough
url	string	mlb.com team page
scrapedAt	string	Extraction timestamp

Rosters (recordType: "rosterPlayer")

{
    "recordType": "rosterPlayer",
    "teamId": 119,
    "teamName": "Los Angeles Dodgers",
    "playerId": 660271,
    "fullName": "Shohei Ohtani",
    "jerseyNumber": "17",
    "position": { "code": "10", "name": "Designated Hitter", "abbreviation": "DH" },
    "status": "Active",
    "stats": { "hitting": { "homeRuns": 54, "avg": ".310", "obp": ".390", "slg": ".646", "ops": "1.036", "rbi": 130 } },
    "url": "https://www.mlb.com/player/660271",
    "scrapedAt": "2026-07-01T14:30:00Z"
}

Field	Type	Description
recordType	string	Always "rosterPlayer"
teamId / teamName	integer / string	Team the roster belongs to
playerId	integer	Player identifier
fullName	string	Player name
jerseyNumber	string	Uniform number
position	object	Position code, name, and abbreviation
status	string	Roster status, e.g. Active
stats	object	Season hitting, pitching, and fielding stats (when includeStats is on)
url	string	mlb.com player page
scrapedAt	string	Extraction timestamp

Players (recordType: "player")

{
    "recordType": "player",
    "id": 660271,
    "fullName": "Shohei Ohtani",
    "primaryNumber": "17",
    "currentTeam": { "id": 119, "name": "Los Angeles Dodgers" },
    "primaryPosition": { "code": "10", "name": "Designated Hitter", "abbreviation": "DH" },
    "birthDate": "1994-07-05",
    "currentAge": 30,
    "birthCity": "Oshu",
    "birthCountry": "Japan",
    "height": "6' 4\"",
    "weight": 210,
    "batSide": "Left",
    "pitchHand": "Right",
    "mlbDebutDate": "2018-03-29",
    "active": true,
    "stats": { "hitting": { "homeRuns": 54, "avg": ".310", "ops": "1.036", "rbi": 130 }, "pitching": { "era": "3.14", "strikeOuts": 167 } },
    "url": "https://www.mlb.com/player/660271",
    "scrapedAt": "2026-07-01T14:30:00Z"
}

Bio fields

Field	Type	Description
recordType	string	Always "player"
id	integer	Player identifier
fullName	string	Player name
primaryNumber	string	Uniform number
currentTeam	object	Current team id and name
primaryPosition	object	Position code, name, and abbreviation
birthDate	string	Date of birth (YYYY-MM-DD)
currentAge	integer	Current age
birthCity / birthCountry	string	Birthplace
height / weight	string / integer	Listed height and weight
batSide / pitchHand	string	Bats and throws
mlbDebutDate	string	MLB debut date
active	boolean	Currently active
url	string	mlb.com player page
scrapedAt	string	Extraction timestamp
stats	object	Season stats (when includeStats is on) — see below

Stats block (present when includeStats is on)

Field	Type	Description
stats.hitting	object	Hitting line: homeRuns, avg, obp, slg, ops, rbi, and more
stats.pitching	object	Pitching line: era, strikeOuts, wins, saves, whip, and more
stats.fielding	object	Fielding line by position

Standings (recordType: "standing")

{
    "recordType": "standing",
    "season": 2025,
    "league": { "id": 103, "name": "American League" },
    "division": { "id": 201, "name": "American League East" },
    "team": { "id": 147, "name": "New York Yankees" },
    "wins": 94,
    "losses": 68,
    "winningPercentage": ".580",
    "gamesBack": "-",
    "wildCardGamesBack": "-",
    "divisionRank": "1",
    "leagueRank": "2",
    "wildCardRank": "-",
    "streak": "W3",
    "runsScored": 815,
    "runsAllowed": 668,
    "runDifferential": 147,
    "clinched": true,
    "scrapedAt": "2026-07-01T14:30:00Z"
}

Field	Type	Description
recordType	string	Always "standing"
season	integer	Season year
league	object	League id and name
division	object	Division id and name
team	object	Team id and name
wins / losses	integer	Wins and losses
winningPercentage	string	Win percentage
gamesBack	string	Games behind the division leader
wildCardGamesBack	string	Games behind the wild-card cutoff
divisionRank / leagueRank / wildCardRank	string	Rank within division, league, and wild-card race
streak	string	Current streak, e.g. "W3"
runsScored / runsAllowed / runDifferential	integer	Run totals and differential
clinched	boolean	Playoff berth clinched
scrapedAt	string	Extraction timestamp

Tips for Best Results

• Leave the dates blank for today's slate — an empty start and end date returns the current day's games with live status and scores.
• Keep a games date range inside one season — for postseason, set gameType to World Series (or Division Series, League Championship) and pin the date range to October of that year to isolate the exact series.
• Turn off includeStats for speed — roster and player runs skip the extra stat fetch per player, so you get names, positions, and bios much faster and cheaper when you don't need full stat lines.
• Name teams however you like — full name, abbreviation, team ID, or a mlb.com team URL all work; leave teams empty to pull all 30 clubs at once.
• Use the Players type for star tracking, Rosters for whole clubs — Players takes an explicit name/ID list, while Rosters pulls every active player on the teams you pick.
• Pick wildCardWithLeaders for a full playoff-picture snapshot — it adds each division leader alongside the wild-card contenders in one standings pull.
• Set season to any year back to 1876 — historical schedules, rosters, and standings are all available for deep multi-season research.

Pricing

From $20.00 per 1,000 results — a flat, predictable rate whether you pull games, standings, rosters, or full player stat lines. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$2.40	$2.26	$2.13	$2.00
1,000	$24.00	$22.60	$21.30	$20.00
10,000	$240.00	$226.00	$213.00	$200.00
100,000	$2,400.00	$2,260.00	$2,130.00	$2,000.00

A "result" is any row in the output dataset — one game, team, roster player, player, or standings entry. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. Platform fees depend on your Apify plan.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate sports research, analytics, journalism, and data products using publicly available Major League Baseball information. You are responsible for complying with applicable laws and the terms of service of the sources involved. Do not use extracted data for any unlawful purpose, and respect all applicable trademarks and intellectual property rights.