MLB Stats Scraper

MLB Stats Scraper

Scrape MLB's official Stats API for teams, rosters, schedules, standings, player stats, and full game details — clean, structured baseball data by season instead of manually browsing MLB.com.

Six modes covering every major MLB dataset — teams, rosters, schedules, standings, hitting/pitching/fielding stats, and box scores — all sourced directly from MLB's own Stats API.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

parsebird/mlb-stats-scraper on Apify. Call: ApifyClient("TOKEN").actor("parsebird/mlb-stats-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: mode (string, "teams"/"players"/"schedule"/"standings"/"playerStats"/"gameDetails", default "teams"), season (integer, default current year), teamId (integer, e.g. 147=Yankees, 111=Red Sox — used by players/schedule), playerId (integer, e.g. 660271=Shohei Ohtani — required for playerStats, used by players), gamePk (integer, required for gameDetails), date (string "YYYY-MM-DD", schedule mode), fromDate/toDate (string, schedule date range), leagueId ("both"/"AL"/"NL", standings mode), statGroup ("hitting"/"pitching"/"fielding", playerStats mode), gameType ("R"/"S"/"P"/"W"/etc, schedule mode), maxItems (integer, default 100, max 10000). Output fields vary by mode: teams give teamId/name/abbreviation/leagueName/divisionName/venueName/mlbUrl; players give playerId/fullName/birthDate/height/weight/primaryPosition/currentTeam/batSide/pitchHand/mlbUrl; schedule gives gamePk/gameDate/homeTeam/awayTeam/homeScore/awayScore/status/venue; standings give teamName/divisionName/wins/losses/pct/divisionRank/gamesBack/streakCode; playerStats give gamesPlayed/homeRuns/rbi/avg/obp/slg/ops/era/whip/wins. Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parsebird~mlb-stats-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations

What does MLB Stats Scraper do?

This Actor scrapes MLB's official Stats API, the same data source that powers MLB.com's own scoreboards and stat pages, and normalizes it into clean, structured records.

• ⚾ Six modes — teams, player rosters/bios, schedules, standings, hitting/pitching/fielding stats, and full game box scores
• 📅 Flexible date filtering — a single date or a date range for schedules, any season year for stats and standings
• 🏆 League and division context — standings include division rank, games back, and streak; teams include league and division name
• 📊 All three stat groups — hitting, pitching, and fielding stats for any player and season
• ⏱️ Scheduling — run this Actor daily during the season to track standings movement or pull the day's schedule
• 🔌 API access — trigger runs and pull results programmatically via the Apify API or client libraries
• 📊 Flexible export — download results as JSON, CSV, or Excel, or query them via API

What data can you extract from MLB Stats?

Field	Description
teamId / name / abbreviation	Team identity (teams mode)
leagueName / divisionName / venueName	Team's league, division, and home stadium
playerId / fullName / birthDate / height / weight	Player bio (players mode)
primaryPosition / currentTeam / batSide / pitchHand	Player role and handedness
gamePk / gameDate / homeTeam / awayTeam / homeScore / awayScore	Game identity and result (schedule/gameDetails)
wins / losses / pct / divisionRank / gamesBack / streakCode	Standings (standings mode)
homeRuns / rbi / avg / obp / slg / ops / era / whip	Hitting/pitching stats (playerStats mode)

Input parameters

Parameter	Type	Required	Default	Description
mode	string	Yes	teams	teams, players, schedule, standings, playerStats, or gameDetails
season	integer	No	current year	MLB season year
teamId	integer	No	—	MLB team ID, e.g. 147 = Yankees, 111 = Red Sox
playerId	integer	No	—	MLB player ID, e.g. 660271 = Shohei Ohtani. Required for playerStats
gamePk	integer	No	—	Game primary key. Required for gameDetails
date	string	No	—	Game date YYYY-MM-DD (schedule mode)
fromDate	string	No	—	Start date for a schedule date range
toDate	string	No	—	End date for a schedule date range
leagueId	string	No	both	both, AL, or NL (standings mode)
statGroup	string	No	hitting	hitting, pitching, or fielding (playerStats mode)
gameType	string	No	all types	R (regular), S (spring), P (playoffs), W (World Series), and other MLB game-type codes
maxItems	integer	No	100	Maximum records to return (1–10,000)

Output example

{
  "gamePk": 744834,
  "gameDate": "2024-07-04T15:05:00Z",
  "homeTeam": "Washington Nationals",
  "awayTeam": "New York Mets",
  "homeScore": 1,
  "awayScore": 0,
  "status": "Final",
  "venue": "Nationals Park"
}

{
  "playerId": 660271,
  "season": 2024,
  "gamesPlayed": 159,
  "homeRuns": 54,
  "rbi": 130,
  "avg": ".310",
  "obp": ".390",
  "slg": ".646",
  "ops": "1.036",
  "era": null,
  "whip": null,
  "wins": null
}

Download results in JSON, CSV, or Excel directly from the Apify Console, or pull them programmatically via the API.

Use cases

• Fantasy baseball research — pull hitting/pitching stats for any player and season to compare performance
• Standings tracking — schedule a daily run against standings mode to track division races over a season
• Schedule aggregation — pull a team's or a whole day's schedule and feed it into your own calendar or app
• Historical analysis — pull team, player, and game data for any past season for research or modeling
• Game recaps — pull gameDetails for a specific gamePk to get box score stats and inning-by-inning line scores

How to scrape MLB stats with this Actor

1. Go to the MLB Stats Scraper page on Apify Store
2. Click Try for free — new users get a free trial to test the Actor before paying
3. Choose a mode and fill in the fields it needs (e.g. teamId for a roster, playerId + season for stats)
4. Set maxItems to cap the run size
5. Click Start — the Actor queries MLB's Stats API and normalizes every result
6. When the run finishes, download your data as JSON, CSV, or Excel, or fetch it via the API

Use with the Apify API

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("parsebird/mlb-stats-scraper").call(run_input={
    "mode": "playerStats",
    "playerId": 660271,
    "season": 2024,
    "statGroup": "hitting",
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['homeRuns']} HR, {item['rbi']} RBI, {item['avg']} AVG")

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('parsebird/mlb-stats-scraper').call({
    mode: 'playerStats',
    playerId: 660271,
    season: 2024,
    statGroup: 'hitting',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.log(`${item.homeRuns} HR, ${item.rbi} RBI, ${item.avg} AVG`);
});

See the Apify API documentation for full reference, or the Actor's API tab for ready-to-run request snippets in more languages.

How much does it cost to scrape MLB stats?

This Actor uses Pay-per-event pricing — you only pay for records actually returned, with no separate platform rental fee.

Plan	Price per event	Price per 1,000
Free	$0.00459	$4.59
Bronze	$0.00419	$4.19
Silver	$0.00349	$3.49
Gold	$0.00289	$2.89

One record-scraped event is charged for each team, player, game, standing, or stat line pushed to the dataset. A 1,000-record run costs about $4.59 on the Free plan or $2.89 on Gold. Start with the free trial and a low maxItems to preview results before scaling up.

FAQ

What team IDs should I use? Common ones: 147 = Yankees, 111 = Red Sox, 112 = Cubs, 117 = Astros, 108 = Angels, 121 = Mets, 119 = Dodgers, 137 = Giants, 144 = Braves, 143 = Phillies. Run mode: "teams" to get the full list of all 30 team IDs.

Why is currentTeam sometimes different from the team I searched under? currentTeam reflects the player's team as of right now, not necessarily the team for the season you requested — a player fetched under a 2024 roster may since have been traded, released, or moved organizations. This is MLB's own data, not a bug.

Why are era/whip/wins (or homeRuns/avg) null in my playerStats result? Those fields only populate for the matching statGroup — hitting stats return null pitching fields and vice versa, rather than a fabricated zero.

What's the difference between schedule and gameDetails? schedule returns lightweight game summaries (score, status, teams) for a date or date range. gameDetails requires a specific gamePk and returns the full box score: inning-by-inning line score and team batting/pitching/fielding stat totals.

Can I schedule recurring runs? Yes. Use Apify's Scheduler to run this Actor daily during the season to track standings or pull each day's schedule automatically.

Is it legal to scrape MLB's Stats API? This data comes from MLB's own publicly accessible Stats API, the same one that powers MLB.com's scoreboards. You're responsible for complying with MLB Advanced Media's terms for your specific use case. See Apify's blog post on the legality of web scraping for general background.

Can I access results via API? Yes. Every run's dataset is available through the Apify API and client libraries (Python, JavaScript) — see the Actor's API tab for ready-made snippets.

Something not working? Open an issue on the Actor's Issues tab in Apify Console — the ParseBird team monitors it directly.

Related Actors

Other sports and market-data Actors from ParseBird:

• Tennis Abstract Player Match Scraper & API — historical tennis match data by player
• Polymarket Leaderboard Scraper — prediction-market leaderboard and odds data
• Polymarket Market Scraper — prediction-market pricing and market data