OrbTop

MLB Stats API — Trade Deadline & Pennant Race Tracker

SPORTSDEVELOPER TOOLS
Try on Apify

MLB Stats API — Trade Deadline & Pennant Race Tracker

Pull live game schedules, standings, wild-card race data, and trade-deadline transactions from the official MLB Stats API (statsapi.mlb.com). Three modes in one actor — the only Apify actor that surfaces the /transactions endpoint for real-time roster moves.

What this actor does

  • Schedule mode — Pulls box scores and game results for any date range. Includes home/away teams, scores, winning/losing/save pitchers, venue, and game status.
  • Standings mode — Snapshots current AL and NL division standings including wild-card race position (wildCardRank, wildCardGamesBack, wins/losses).
  • Transactions mode — The trade-deadline differentiator: streams roster moves (trades, DFA, call-ups, options) from the /transactions endpoint for any date window.

Input

Field Type Default Description
mode string schedule schedule, standings, or transactions
startDate string today Start date YYYY-MM-DD (schedule / transactions)
endDate string startDate End date YYYY-MM-DD (schedule / transactions)
leagueIds string 103,104 League IDs for standings (103=AL, 104=NL)
gameType string R Game type: R=Regular, S=Spring, E=Exhibition, D=Division Series
maxItems integer 10 Maximum records to return (0 = no limit)

Output schema

Every record shares the same 17-field flat schema regardless of mode:

Field Notes
game_pk MLB game ID (or transaction ID)
game_date Date YYYY-MM-DD
game_type R / standings / transaction
season MLB season year
home_team / home_team_abbrev Home team name and abbreviation
home_score Runs scored (home) — wins count in standings mode
away_team / away_team_abbrev Away team or division rank in standings mode
away_score Runs scored (away) — losses in standings mode
venue Ballpark name — games back in standings mode
status Game status or wild-card games back
winning_pitcher WP name (Final games) — wild-card rank in standings
losing_pitcher LP name (Final games) — games played in standings
save_pitcher Save pitcher name if applicable
home_runs_total Total HRs in game (when available)
source statsapi.mlb.com/schedule | /standings | /transactions

Trade deadline use case

The July 31 trade deadline is the highest-traffic period in baseball analytics. Set mode: transactions with startDate: 2026-07-28 and endDate: 2026-08-01 to capture every roster move in the deadline window:

{
  "mode": "transactions",
  "startDate": "2026-07-28",
  "endDate": "2026-08-01",
  "maxItems": 0
}

Pennant race use case

Track the wild-card standings as the pennant race heats up in August and September:

{
  "mode": "standings",
  "leagueIds": "103,104",
  "maxItems": 0
}

API details

  • Source: https://statsapi.mlb.com/api/v1/ (official MLB Stats API)
  • Authentication: none required — fully open public API
  • Rate limits: generous; actor uses a 150ms courtesy delay
  • Proxy: none needed
Try on Apify