⚾ MLB Stats Scraper

Extract official MLB baseball data: player profiles, team rosters, schedules, standings, and league leaders, as clean, structured records. Search by player and team name. No need to know internal numeric IDs. No login, no account, no manual copying.

🎯 Who uses it?

🎮 Fantasy baseball players

Pull season stats and rosters by name to set weekly lineups. No ID lookups first.

🎲 Bettors & model builders

Build predictive models from season and career hitting, pitching, and fielding lines.

📊 Analysts & researchers

Track standings, streaks, and league leaders across a season or a player's whole career.

✍️ Journalists & content creators

Pull accurate stat lines and schedules for game previews, recaps, and player profiles.

✨ What it does

• Player profiles: bio (age, bats/throws, height, weight, birthplace, MLB debut) plus season or career hitting, pitching, or fielding stats, auto-detected by position, or forced to one group.
• Teams: abbreviation, league, division, venue, and (optionally) the full current roster.
• Schedule: games by date, date range, or team, with final scores, status, each team's record at the time, probable pitchers, and weather. Turn on box scores for the inning-by-inning line score, hits/errors, and the winning/losing/save pitcher.
• Standings: division rank, win/loss record, games back, streak, run differential, magic number.
• League leaders: the top players in any stat category (home runs, ERA, batting average, strikeouts, saves, and more), ranked.
• Find players and teams by name, like "Aaron Judge" or "Yankees", or pass numeric IDs directly if you already have them from a previous run.
• Player headshots, team logos, and a link to the official profile page on every row.
• Heights/weights are normalized to metric (cm / kg) alongside the original record.

🏆 Why this scraper

• Find players and teams by name. Every other MLB scraper on Apify makes you already know the internal numeric ID. This one takes "Aaron Judge" or "Yankees".
• Five modes in one actor: player profiles, teams and rosters, schedule, standings, and league leaders.
• Box scores, probable pitchers and weather on the schedule, which the other MLB scrapers do not pull.
• A declared dataset schema so the Apify Console shows a clean table, plus headshots, team logos and official profile links on every row.
• No login, no API key.

⚖️ How it compares

Capability	This actor	Other MLB scrapers on Apify
Player, team, schedule, standings, leaders	yes	some (most cover 1-2)
Look up players and teams by name	yes	no (numeric ID only)
Season and career hitting / pitching / fielding	yes	some
Box scores: inning-by-inning, hits/errors, decisions	yes	no
Probable pitchers and weather on the schedule	yes	no
Headshots, team logos, official profile links	yes	rare
Declared dataset schema + free-plan preview	yes	no
Metric heights / weights alongside the original	yes	no

📦 What data you get

Entity	Useful fields
Player	Name, age, position, bats/throws, team, season or career hitting/pitching/fielding stats, height, weight, birthplace, MLB debut date, headshot photo, profile link.
Team	Name, abbreviation, league, division, venue, first year of play, logo, and the full current roster (name, position, jersey number, status).
Game	Away/home team, score, winner, status, date, venue, each team's record, probable pitchers, weather. With box scores on: inning-by-inning line score, hits/errors, and winning/losing/save pitcher.
Standing	Team, division rank, W-L record, win %, games back, streak, runs scored/allowed, magic number.
Leader	Rank, player, team, stat category and value.

Every record includes scraped_at (UTC) and source. Download your dataset from Apify as CSV, JSON, Excel, or XML.

💡 Use cases

🎮 Set a fantasy lineup from current stats

{
  "mode": "players",
  "playerNames": ["Shohei Ohtani", "Mookie Betts", "Juan Soto"]
}

🎲 Compare a pitcher's career vs. this season

{
  "mode": "players",
  "playerNames": ["Gerrit Cole"],
  "statType": "career"
}

📅 Get every game a team played in a date range

{
  "mode": "schedule",
  "teamNames": ["Yankees"],
  "fromDate": "2026-06-01",
  "toDate": "2026-06-30"
}

📊 Check the standings

{
  "mode": "standings",
  "league": "AL"
}

🏆 Get the home run leaderboard

{
  "mode": "leaders",
  "leaderCategory": "homeRuns",
  "maxItems": 25
}

⚾ Get full box scores for a day's games

{
  "mode": "schedule",
  "date": "2026-06-15",
  "includeBoxScore": true
}

🧢 Pull a full team roster

{
  "mode": "teams",
  "teamNames": ["Dodgers"],
  "includeRoster": true
}

⚙️ How the input is organised

The input form is split into four numbered sections. Every field's title says which mode(s) it applies to, so it's always clear what to fill in and what to leave alone.

Section	What it's for
1 · What do you want to scrape?	Pick one type of data: Player profiles, Teams, Schedule, Standings, or League leaders.
2 · Who or what to get	Fill in only what your mode needs: player names or IDs for Player profiles; team names or IDs for Teams and Schedule; a date, date range, or team for Schedule; a league (AL/NL/both) for Standings; a stat category (e.g. homeRuns, era) for League leaders. A season field is available for every mode except Schedule.
3 · How much to collect	Maximum rows for the whole run.
4 · What to include	Stat type (auto, hitting, pitching, or fielding) and season vs. career, for Player profiles. Whether to attach the full roster, for Teams. Whether to add box-score details, for Schedule.

Apify Free plan: every run is limited to a fixed 10-row sample. Upgrade your Apify plan to run your own settings.

💰 Pricing

Pay-per-event: a one-time 0.01 when the run starts, plus a price per result saved to your dataset. The price depends on your Apify plan tier:

Your Apify plan	Price per result
Free	0.0143
Bronze	0.0121
Silver	0.0103
Gold / Platinum / Diamond	0.008

Approximate total cost (includes the 0.01 start fee):

Results collected	Free	Bronze	Silver	Gold+
100	$1.44	$1.22	$1.04	$0.81
1,000	$14.31	$12.11	$10.31	$8.01
10,000	$143.01	$121.01	$103.01	$80.01

New Apify accounts start with $5 in free credit.

🚀 Run it

1. Create a free Apify account with $5 in credit.
2. Open the Mlb Stats Scraper.
3. Fill in the input (or keep the prefilled example), set the maximum number of results, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python, and schedule it with Apify's built-in Scheduler.

🤖 Use with AI agents (MCP)

Give an AI agent live access to the Mlb Stats Scraper through the Model Context Protocol:

claude mcp add --transport http apify "https://mcp.apify.com?tools=normdata/mlb-stats-scraper"

Then prompt it in plain language to run the scraper and read back the results.

🔧 Troubleshooting

A player or team was skipped. It couldn't be found; the run log names it and the rest continues. Use a fuller name ("Aaron Judge") or the numeric MLB ID.

I got stats for the wrong season. Set Season (year). It applies to every mode except Schedule, which uses dates.

Which fields apply to my run? Only the fields marked for the Type of data you chose are used.

❓ FAQ

Question	Answer
Is this official data?	Yes, official MLB statistics.
Can I find players by name?	Yes, no internal IDs needed.
Does it include box scores?	Yes, turn on Box score details in Schedule mode.
Are heights and weights metric?	Both: normalized cm/kg alongside the original.
Do I need an API key?	No.

🛡️ Limits & responsible use

This Actor collects only publicly available, official MLB statistics. It never signs in and never accesses anything gated behind an account.

If a player, team, or game can't be found, that entry is skipped with a warning in the run log. The rest of the run continues.

📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

🧪 Local development

bun install
bun run typecheck
bun test
bun run start

Test with a sample storage/key_value_stores/default/INPUT.json, e.g.:

{ "mode": "players", "playerNames": ["Aaron Judge"], "maxItems": 5 }