⚾ MLB Stats Scraper

🚀 Export official Major League Baseball data in seconds. Pull schedules by date, all 30 MLB teams, full rosters, season player stats, and live game feeds from the official MLB feed. No sign-up, no manual scraping, no setup.

🕒 Last updated: 2026-05-15 · 📊 25+ fields per record · ⚾ All 30 MLB teams · 📅 Schedules + rosters + stats · 🔴 Live game feed

The MLB Stats Scraper exports official Major League Baseball data and returns up to 25+ structured fields per record, including game primary key (gamePk), official date, gameType, season + season display, status, both teams (with score, league record, winner flag), venue, day/night designation, double-header indicator, scheduled innings, and a public deep-link to MLB.com Gameday.

The Actor covers all 30 MLB teams, every regular and postseason game, complete 40-man and active rosters, season-by-season player stats, and the live game feed (linescore, decisions, full game data). One run gives you the dataset you need for fan-engagement, fantasy, betting analytics, content automation, or research.

🎯 Target Audience	💡 Primary Use Cases
Sports media, fantasy-baseball apps, betting analytics teams, fan-engagement platforms, indie sports devs, baseball researchers	Live scoreboards, fixture feeds, roster lookups, player season-stat dashboards, postseason brackets, content automation

---

📋 What the MLB Stats Scraper does

Five lookup modes in a single run:

• 📅 Schedule. Games on a chosen date (defaults to today). Filter by gameType (Regular, Wild Card, Division Series, League Championship, World Series, All-Star) or by seasonType shortcut (regular / post).
• 🏟️ Teams. All 30 MLB teams with abbreviations, codes, league + division, venue, first-year-of-play, and short name.
• 📋 Roster. Active roster for one team (by teamId) or batch up to 100 teams in one run.
• 📊 Player Stats. Season stats for one or many players, with bio (height, weight, birth date, country, bats/throws), position, and current team.
• 🔴 Game Detail. Live feed for any game by gamePk, including game data, linescore, and pitching/winning decisions.

Each schedule record includes the canonical MLB identifiers, official date, season + season display, gamedayType, series description with game number, both teams (ID, name, score, league record, winner flag), venue, day/night, double-header type, scheduled innings, and a direct link to mlb.com/gameday.

💡 Why it matters: baseball moves fast, and accurate game and player data underpin every scoreboard, fantasy product, and analytics dashboard. Building your own pipeline means juggling MLB's data feed, normalising IDs across season types, and refreshing for every game day.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
mode	string	"schedule"	One of schedule, teams, roster, playerStats, gameDetail.
date	string	today	YYYY-MM-DD. Used in schedule mode.
teamId	integer	none	MLB team ID for roster mode (e.g. 147 = Yankees, 119 = Dodgers).
teamIds	array	[]	Batch roster lookup. Takes precedence over teamId.
playerId	string	""	MLB player ID for playerStats mode (e.g. 660271 = Shohei Ohtani).
playerIds	array	[]	Batch playerStats lookup. Takes precedence over playerId.
gameType	string	""	R/F/D/L/W/A. Filter schedule by game type.
seasonType	string	""	regular or post shortcut.
gamePk	integer	none	Game primary key for gameDetail mode.
season	integer	current	Season year (e.g. 2024).
maxItems	integer	10	Free plan caps at 10, paid plan at 1,000,000.

Example: today's schedule, regular season only.

{
    "mode": "schedule",
    "seasonType": "regular",
    "maxItems": 30
}

Example: Shohei Ohtani's 2024 season stats.

{
    "mode": "playerStats",
    "playerId": "660271",
    "season": 2024
}

⚠️ Good to Know: seasonType is a convenience shortcut. If you supply gameType directly (e.g. W for World Series), it overrides seasonType. The Actor is smart enough to map the right combination for postseason rounds.

---

📊 Output

Each schedule record contains 25+ fields. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema (schedule mode)

Field	Type	Example
🆔 gamePk	number	746345
🔗 gameGuid	string	"abcd-1234..."
📅 gameDate	ISO 8601	"2026-05-15T18:05:00Z"
📅 officialDate	string	"2026-05-15"
🏷️ gameType	string	"R"
🗓️ season	string	"2026"
📺 gamedayType	string	"P"
🏆 seriesDescription	string	"Regular Season"
🔢 seriesGameNumber	number	1
🚦 status	object	{"detailedState": "Scheduled"}
📊 awayScore	number | null	5
📊 homeScore	number | null	3
🏠 teams.home	object	{"id": 147, "name": "New York Yankees", ...}
🛫 teams.away	object	{"id": 111, "name": "Boston Red Sox", ...}
🏟️ venue	object	{"id": 3313, "name": "Yankee Stadium"}
🌗 dayNight	string	"night"
🔁 doubleHeader	string	"N"
📐 scheduledInnings	number	9
🔗 url	string	"https://www.mlb.com/gameday/746345"
🕒 scrapedAt	ISO 8601	"2026-05-15T00:00:00.000Z"

📦 Sample record

---

✨ Why choose this Actor

	Capability
⚾	Full league. All 30 MLB teams across both leagues, with active rosters and season stats.
📅	Daily schedule. Every game on any date, filtered by season type or game type.
🏆	Postseason support. Wild Card, Division Series, League Championship, World Series, and All-Star coded out of the box.
📊	Player stats. Season hitting and pitching splits joined with player bio and current team.
🔴	Live feed. Linescore, decisions, and full game data for any in-progress matchup.
🔁	Always fresh. Each run pulls live data, so scores and lineups reflect the current state.
🚫	No sign-up. Works against the official MLB live feed. No login or token required.

📊 Reliable MLB data is the foundation of every fantasy product, betting model, and fan-facing scoreboard.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ MLB Stats Scraper (this Actor)	$5 free credit, then pay-per-use	30 teams, 5 modes, live + season	Live per run	mode, date, gameType, season	⚡ 2 min
Commercial sports data vendors	$$$$/month	Full + extras	Streaming	Many	⏳ Weeks
Manual stats-page scraping	Free	Inconsistent	On demand	None	🐢 Days
Free baseball widgets	Free	Display-only	Live	Limited	🕒 No raw data

Pick this Actor when you want structured records, all 30 teams, and zero pipeline maintenance.

---

🚀 How to use

1. 📝 Sign up. Create a free account w/ $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the MLB Stats Scraper page on the Apify Store.
3. 🎯 Set input. Pick a mode, fill the relevant inputs (date, team ID, player ID, or gamePk), and set maxItems.
4. 🚀 Run it. Click Start and let the Actor collect your data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

📺 Sports Media & Publishing Daily MLB scoreboard rendering on news sites Auto-write game previews with rosters and venues Postseason bracket dashboards with live scores Push breaking news on walk-offs and no-hitters	🎲 Fantasy & Betting Analytics Pre-game lineup and roster checks Live in-play model inputs from the linescore feed Backtest strategies against historical schedules Postseason-only filters for derivatives markets
🏟️ Fan-Engagement Apps "My team" alerts and push notifications Game-day stadium guides with venue + day/night Player stat cards in fan apps and Discord bots Season-long leaderboard widgets	📊 Analytics & Research Build sabermetrics dashboards with raw splits Train models on schedule + outcome metadata Cross-reference player IDs across multiple feeds Time-series studies on day vs night performance

---

🔌 Automating MLB Stats Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Refresh today's scoreboard every minute, daily roster snapshots, or weekly stats pulls are all one click.

---

🌟 Beyond business use cases

Baseball data powers more than commercial products. The same records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Sabermetrics coursework with real season data Statistical studies on home advantage, day vs night, and travel Sport-history dissertations grounded in live records Reproducible research pulls with cited timestamps	🎨 Personal and creative Hobbyist team tracker dashboards Discord bots for fan communities Trading-card generators with current rosters Side projects and fan portfolios
🤝 Non-profit and civic Youth-baseball league dashboards Sport-journalism for local newsrooms Inclusion analyses across rosters and birth countries Open-data hackathons on America's pastime	🧪 Experimentation Train win-probability ML models with live linescores Prototype agent pipelines that resolve player IDs Validate fan-product hypotheses with real fixture data Test live-stream UX concepts with real game feeds

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a mode (schedule, teams, roster, playerStats, or gameDetail), supply the relevant inputs, and click Start. The Actor pulls fresh records from the official MLB live data feed and emits a clean structured row per game, team, player, or live feed entry.

⚾ Which teams are supported?

All 30 Major League Baseball teams across both the American League and National League.

📅 Can I get postseason games only?

Yes. Set seasonType to post (or use gameType like W for World Series specifically) and the Actor restricts the schedule to playoff games.

📊 How do I look up player season stats?

Set mode to playerStats and supply playerId (e.g. 660271 for Shohei Ohtani). Optionally set season to a year (defaults to current). Use playerIds for batch lookups (up to 100 per call).

🔴 Can I pull a live game feed?

Yes. Set mode to gameDetail and supply gamePk for the game you want. The Actor returns live game data, current linescore, and pitching/winning decisions if the game is final.

🏟️ Do I get venue and day/night info?

Yes. The schedule mode returns the full venue object plus dayNight and doubleHeader flags so you can build accurate game-day dashboards.

⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor every minute, hourly, or daily. The dataset always reflects the current state of the live feed.

⚖️ Is this data legal to use?

Only publicly available scoreboard data is collected. Review MLB's terms of use for your specific use case, particularly if you redistribute or commercialise the content.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and unlocks scheduling and higher concurrency.

🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

MLB Stats Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get score updates in your channels
• n8n - Self-hosted workflow automation
• Pipedream - Event-driven serverless workflows
• Airbyte - Pipe baseball data into your warehouse
• GitHub - Trigger runs from commits
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh schedules into your product backend, or alert your fans in Slack when a walk-off happens.

---

🔗 Recommended Actors

• 🏒 NHL Stats Scraper - 32-team standings, schedules, player landing
• 🏆 Sofascore Live Events Scraper - 13-sport live + scheduled events feed
• 🥅 TheSportsDB Scraper - Crowd-sourced sports database across leagues
• 🛡️ CWE MITRE Scraper - Software weakness reference catalogue
• 📊 OurAirports Scraper - Global airport reference dataset

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Major League Baseball or any of its clubs. All trademarks mentioned are the property of their respective owners. Only publicly available scoreboard data is collected.