BaseballData API
Data
Coverage
MLB seasons held129MLB 2026 games2,469Postseason line scores40WBC and Premier12 games242Czech box scores1,430
See all coverage
DocsPricingStatus

Baseball Data API

Every major-league game since 1897, pitch by pitch

Box scores, play by play, parks, umpires and the weather at first pitch for 220,475 MLB games, plus the minors and eight leagues abroad. One key. One JSON shape for every league.

Free key, no cardMCP serverFinals within minutes
api.baseballapi.netLive example
GET/v1/results/yesterday200
Example answer, drawn as a tableTry it in the docs
220,475MLB games, 1897 to 2026217,997MLB box scores206,492with play by play210,839with the weather30,026minor-league team seasons10,612Cuban games1,434Czech games2,263Mexican Pacific League games611CPBL games242WBC and Premier12 games207Bundesliga games119Venezuelan League games12,476KBO games

What we hold

The record, counted

Major-league baseball game by game since 1897, with the box score, the plays and the weather behind most of it, and the history around it.

Counted 16:27 UTC today
MLB games220,475
1897 to 2026every season
With box scores217,997
of every game99%
With play by play206,492
every plate appearance94%
With the weather210,839
at first pitch96%
Games abroad27,964
KBO, CPBL, Cuba and moreeight leagues
Minor-league team seasons30,026
back to 1877team by team

The API

One shape for every league

11 endpoints, the same JSON whether the game was in 1897 or last night, in the majors or abroad. Pick one to see the call and what comes back.

Base URLhttps://api.baseballapi.net/v1
MethodEndpointMCP tool
GET/v1/{league}/gamesGames in a league on a day or across a range of days, with final scores.find_games
GET/v1/results/yesterdayEvery finished game from yesterday in every league, newest league first.yesterdays_results
GET/v1/{league}/games/{id}One game with its line score, the weather at the ground and the umpires, where held.get_game
GET/v1/{league}/games/{id}/playsEvery plate appearance of one game in order, with the pitches where they were recorded.get_plays
GET/v1/{league}/games/{id}/boxscoreBatting and pitching lines for both sides of one game, where held.get_boxscore
GET/v1/leaguesEvery league we hold, with its seasons and how many of its games carry each part of the record.list_leagues
GET/v1/parksEvery major-league ground held, with its first and last game; or the grounds used in one season.find_parks
GET/v1/parks/{id}One ground, and season by season its games, runs per game and park factor.get_park
GET/v1/playersFind people in the US majors and Negro Leagues by name: players, managers, coaches and umpires.find_players
GET/v1/players/{id}One person: names, birth and death, bats and throws, height and weight, and each role with its dates.get_player
GET/v1/usageYour key's plan, calls today, limits, when they reset, and the days your plan can read. Not counted against your allowance.my_usage
200application/jsonX-RateLimit-Remaining: 59
Example answer: the shape is real, the teams are notEvery field in the docs
Your key

In one header, made when you sign in with Google. Free keys need no card.

X-API-Key: bba_live_...
Paging

Pages or a cursor on every list, up to 50 rows a page.

?per_page=50&cursor=...
Limits

Your allowance comes back in the headers of every answer.

X-RateLimit-Reset: 1762128000
For tools

OpenAPI for code generators, and 11 MCP tools for assistants.

/openapi.json

Inside every game

Six records in one game

Every game comes back as the same set of parts, whatever the league or the year. Here is one, taken apart.

Shares are of MLB games
MLBAway club at Home club
2026-10-24 · Postseason · Final
Line score
123456789RHEAway club001002000370Home club010000100281
Box score, away
BatterABRHRBI
Batter one, CF4120
Batter two, SS5011
Batter three, 1B4112
Batter four, DH3120
Play by play, top of the 6th
  1. Single to centre0-1
  2. Walk0-1
  3. Double to left, two score2-1
  4. Fly out to right2-1
Pitches, the double
BallStrikeFoulIn play
Weather at first pitch
14°C11km/h out to left0mm rain
Ground and crew
Home groundPark factor 101HP Umpire one1B Umpire two
  1. 1
    Line score

    Runs by inning, hits and errors, extra innings and all.

    /v1/{league}/games/{id}
    every final
  2. 2
    Box score

    Batting and pitching lines for everyone who played, with decisions.

    /v1/{league}/games/{id}/boxscore
    99%
  3. 3
    Play by play

    Every plate appearance in order, with the count and the result.

    /v1/{league}/games/{id}/plays
    94%
  4. 4
    Pitches

    Each pitch as it was scored: ball, strike, foul or in play.

    /v1/{league}/games/{id}/plays
    most games from 1988
  5. 5
    Weather

    Temperature, wind and rain at the ground at first pitch.

    /v1/{league}/games/{id}
    96%
  6. 6
    Ground and crew

    The park with its park factor, and the umpires by position.

    /v1/parks/{id}
    parks back to 1897
Assistant with Baseball Data API11 tools

Find yesterday's finals and tell me which starter threw the most pitches.

yesterdays_results{}7 games
get_boxscore{ "id": "gm_9tw9rna6" }2 sides
get_boxscore{ "id": "gm_4kd81mzq" }2 sides

Pitcher one threw the most: 108 pitches over 7 innings for the home club, with 9 strikeouts and one walk. The next highest was 101.

StarterIPPitchesSO
Pitcher one7.01089
Pitcher two6.11016
Pitcher three5.2944
Ask about any game

For assistants

Ask Claude, it calls the API

Give an assistant your key and it finds the games, reads the box scores and does the sums itself.

  • MCP server

    Every endpoint as a tool, for Claude Code, Cursor and any MCP client.

    https://baseballapi.net/mcpSet up
  • Agent skill

    One file that teaches an agent the calls, the limits and the errors.

    /skill.mdRead it
  • The manual

    The whole API in one Markdown file, for an agent to read at once.

    /documentation/manual.mdOpen
claude mcp add --transport http baseballapi \
  https://baseballapi.net/mcp \
  --header "X-API-Key: YOUR_KEY"

Plans

Start free, pay for the record

Every plan reads every endpoint and works with the MCP server. Paid plans open the history and raise the limits.

Free key
$0for good
No card needed
  • Yesterday, today and ahead
  • 50 calls a day
  • 10 calls a minute
  • Every endpoint
Get a free keyMade when you sign in
Live
$39a month
or $390 a year
  • This season and last
  • 10,000 calls a day
  • 60 calls a minute
  • Box scores and plays
Choose LiveCancel any time
The whole recordArchive
$69a month
or $690 a year
  • Every season since 1897
  • 50,000 calls a day
  • 120 calls a minute
  • Every league
Choose ArchiveCancel any time
Complete
$99a month
or $990 a year
  • Everything in Archive
  • 250,000 calls a day
  • 300 calls a minute
  • Priority support
Choose CompleteCancel any time
Free keyLiveArchiveComplete
Seasons you can readYesterday, today and aheadThis season and lastEvery season since 1897Everything in Archive
Calls a day5010,00050,000250,000
Calls a minute1060120300
Paid yearlyFree$390$690$990
Every endpoint
MCP server and agent skill
Priority support---

Prices in US dollars. Card charges show as DEVELOPERDATA.NET. Everything about plans

Questions

Asked and answered

Short answers here. The docs go into every field, and support answers the rest.

01Which leagues do you hold?

11 in all. Every league comes back in the same shape, under its own address: /v1/{league}/games.

MLBMinor leaguesKBOCPBLLMPLVBPSerie NacionalBundesligaExtraliga and 1. ligaWBC and Premier12Negro Leagues
02How quickly do results arrive?

MLB finals are checked every five minutes in season. The rest follow their own rhythm:

MLBFinals every 5 minutes in season
Minor leaguesGrowing every hour
KBOResults the same night
CPBLResults the same night
LMPBy the next morning UTC
LVBPBy the next morning UTC
Serie NacionalThe next day
BundesligaThe same day
Extraliga and 1. ligaThe next morning
WBC and Premier12Complete history
Negro LeaguesComplete history
03How far back does play by play go?

For MLB, most games from the early 20th century and nearly every game since the 1970s, with the pitches for most games from 1988.

04Does it include pitch tracking such as exit velocity?

No. We hold each pitch as it was scored: ball, called or swinging strike, foul, or in play.

05Is the free key real data?

Yes. Yesterday's and today's games and the schedule ahead, in exactly the shape the paid plans return.

06Do the ids stay the same?

Yes. Games, people and parks carry our own ids (gm_, pl_, pk_) and they never change, so you can store them.

07Can I use it from Claude or another assistant?

Yes. Add the MCP server with your key, or hand an agent the skill file. It then calls the API for you.

08Can I cancel a paid plan?

Any time, from the billing page of your account. Card charges show as DEVELOPERDATA.NET.

Your key is waiting

220,475 games.
One key.

Start free in a minute with Google. Read yesterday's games tonight, and open the whole record since 1897 when you need it.

Free key, no card11 endpoints11 MCP tools11 leagues