MLB Stats Scraper ⚾

Scrape official Major League Baseball data directly from the official MLB Stats API. Access all 30 MLB teams, full rosters, player info, real-time game schedules, final/live scores, and division & league standings — fast, 100% reliable, and with no API keys or browser automation needed.

---

🌟 Key Features

• ⚡ Direct Official API Connection: Queries official MLB endpoints with sub-second response times and 99.9% uptime.
• ⚾ All 30 MLB Teams & Venues: Team names, abbreviations, divisions, leagues, and stadium/venue details.
• 👥 Active Rosters & Player Details: Jersey numbers, positions, roster status, and player IDs.
• 🏆 Complete Standings: Wins, losses, winning percentages, games back, streaks, run differential, and home/away splits.
• 📅 Schedules & Scores: Matchups, game status, inning linescores, hits, errors, and winner/loser stats.
• 🛡️ 100% Free of Bot-Blocks: Pure public JSON API access with built-in UAG-SG guardrails.

---

📥 Input Parameters

Parameter	Type	Default	Description
mode	String (select)	"standings"	Data to scrape: teams, roster, schedule, standings, or all.
season	Integer	2026	MLB Season year.
teamIds	Array of strings	[]	Optional team IDs or names (e.g. ["Yankees", "Dodgers"] or [147, 119]).
startDate	String	""	Start date for schedules/scores (YYYY-MM-DD).
endDate	String	""	End date for schedules/scores (YYYY-MM-DD).
maxResults	Integer	100	Maximum number of records to return.

---

📤 Output Formats

Standings Record

{
  "type": "standing",
  "id": "mlb-standing-147-2026",
  "teamId": 147,
  "teamName": "New York Yankees",
  "league": "American League",
  "division": "American League East",
  "divisionRank": "1",
  "leagueRank": "1",
  "wins": 75,
  "losses": 45,
  "winningPercentage": ".625",
  "gamesBack": "-",
  "streak": "W3",
  "runsScored": 612,
  "runsAllowed": 480,
  "runDifferential": 132,
  "homeRecord": "40-20",
  "awayRecord": "35-25",
  "lastTen": "7-3",
  "season": 2026,
  "source": "Official MLB Stats API",
  "scrapedAt": "2026-08-17T05:34:00.000Z"
}

Game Schedule Record

{
  "type": "game",
  "id": "mlb-game-745120",
  "gameId": 745120,
  "gameDate": "2026-08-16T23:05:00Z",
  "officialDate": "2026-08-16",
  "status": "Final",
  "isFinal": true,
  "homeTeam": { "id": 147, "name": "New York Yankees", "score": 6, "isWinner": true },
  "awayTeam": { "id": 111, "name": "Boston Red Sox", "score": 3, "isWinner": false },
  "venue": "Yankee Stadium",
  "linescore": { "homeHits": 9, "homeErrors": 0, "awayHits": 5, "awayErrors": 1 },
  "season": 2026,
  "source": "Official MLB Stats API",
  "scrapedAt": "2026-08-17T05:34:00.000Z"
}

---

💰 Pricing

This Actor uses Pay Per Event (PPE) pricing:

Event	Price
stat-record	$0.005 per item ($5.00 / 1,000 stats/games)

---

🔗 Related Actors

• Sports Betting & Odds Intelligence — Live odds and arbitrage for MLB, NBA, NFL, Soccer.