Baseball Data API
Every major-league game since 1897, pitch by pitchBox 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.
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.
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.
https://api.baseballapi.net/v1| Method | Endpoint |
|---|---|
| GET | /v1/{league}/gamesGames in a league on a day or across a range of days, with final scores. |
| GET | /v1/results/yesterdayEvery finished game from yesterday in every league, newest league first. |
| GET | /v1/{league}/games/{id}One game with its line score, the weather at the ground and the umpires, where held. |
| GET | /v1/{league}/games/{id}/playsEvery plate appearance of one game in order, with the pitches where they were recorded. |
| GET | /v1/{league}/games/{id}/boxscoreBatting and pitching lines for both sides of one game, where held. |
| GET | /v1/leaguesEvery league we hold, with its seasons and how many of its games carry each part of the record. |
| GET | /v1/parksEvery major-league ground held, with its first and last game; or the grounds used in one season. |
| GET | /v1/parks/{id}One ground, and season by season its games, runs per game and park factor. |
| GET | /v1/playersFind people in the US majors and Negro Leagues by name: players, managers, coaches and umpires. |
| GET | /v1/players/{id}One person: names, birth and death, bats and throws, height and weight, and each role with its dates. |
| GET | /v1/usageYour key's plan, calls today, limits, when they reset, and the days your plan can read. Not counted against your allowance. |
In one header, made when you sign in with Google. Free keys need no card.
X-API-Key: bba_live_...Pages or a cursor on every list, up to 50 rows a page.
?per_page=50&cursor=...Your allowance comes back in the headers of every answer.
X-RateLimit-Reset: 1762128000OpenAPI for code generators, and 11 MCP tools for assistants.
/openapi.jsonInside 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.
| Batter | AB | R | H | RBI |
|---|---|---|---|---|
| Batter one, CF | 4 | 1 | 2 | 0 |
| Batter two, SS | 5 | 0 | 1 | 1 |
| Batter three, 1B | 4 | 1 | 1 | 2 |
| Batter four, DH | 3 | 1 | 2 | 0 |
- Single to centre0-1
- Walk0-1
- Double to left, two score2-1
- Fly out to right2-1
- 1Line score
Runs by inning, hits and errors, extra innings and all.
/v1/{league}/games/{id}every final - 2Box score
Batting and pitching lines for everyone who played, with decisions.
/v1/{league}/games/{id}/boxscore99% - 3Play by play
Every plate appearance in order, with the count and the result.
/v1/{league}/games/{id}/plays94% - 4Pitches
Each pitch as it was scored: ball, strike, foul or in play.
/v1/{league}/games/{id}/playsmost games from 1988 - 5Weather
Temperature, wind and rain at the ground at first pitch.
/v1/{league}/games/{id}96% - 6Ground and crew
The park with its park factor, and the umpires by position.
/v1/parks/{id}parks back to 1897
Find yesterday's finals and tell me which starter threw the most pitches.
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.
| Starter | IP | Pitches | SO |
|---|---|---|---|
| Pitcher one | 7.0 | 108 | 9 |
| Pitcher two | 6.1 | 101 | 6 |
| Pitcher three | 5.2 | 94 | 4 |
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"
{ "mcpServers": { "baseballapi": {
"url": "https://baseballapi.net/mcp",
"headers": { "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.
- Yesterday, today and ahead
- 50 calls a day
- 10 calls a minute
- Every endpoint
- This season and last
- 10,000 calls a day
- 60 calls a minute
- Box scores and plays
- Every season since 1897
- 50,000 calls a day
- 120 calls a minute
- Every league
- Everything in Archive
- 250,000 calls a day
- 300 calls a minute
- Priority support
| Free key | Live | Archive | Complete | |
|---|---|---|---|---|
| Seasons you can read | Yesterday, today and ahead | This season and last | Every season since 1897 | Everything in Archive |
| Calls a day | 50 | 10,000 | 50,000 | 250,000 |
| Calls a minute | 10 | 60 | 120 | 300 |
| Paid yearly | Free | $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.
02How quickly do results arrive?
MLB finals are checked every five minutes in season. The rest follow their own rhythm:
| MLB | Finals every 5 minutes in season |
| Minor leagues | Growing every hour |
| KBO | Results the same night |
| CPBL | Results the same night |
| LMP | By the next morning UTC |
| LVBP | By the next morning UTC |
| Serie Nacional | The next day |
| Bundesliga | The same day |
| Extraliga and 1. liga | The next morning |
| WBC and Premier12 | Complete history |
| Negro Leagues | Complete 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.