❗️
Deprecation Alert
Please note that this API version is planned for deprecation in July 2025.
The current, stable version of our MLB API is v8. We suggest integrating with this version.

API Map

To best utilize the MLB API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables.

Data Retrieval Examples

To find how many home runs a team has hit when playing at home:

Call the League or Season Schedule and find the Team Id
Call the Seasonal Splits using the Team Id
Find the Home Game statistics, Hitting element, with the Home Run attribute

The home teams number of home runs is displayed.

To find the away teams starting pitcher for a game:

Call the league or season schedule and find id for the game you want
Call the Game Boxscore using the Game ID
Find the Away Team Starting Pitcher element with the First and Last Name attributes

The starting pitcher's name is displayed.

Coverage Levels

We provide three different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.

Full – We provide live pitch-by-pitch coverage for the entire game. We provide updated live events as well as team- and player-level data in near real time. Full coverage is available for all regular and postseason games.

Boxscore – We provide runs each inning, as well as the total runs, hits, and errors, in a timely manner, as the game progresses. Boxscore coverage is only used as a failover for Spring Training games.

Spring Training – We provide live play-by-play coverage, including all events where an out was recorded or a runner advanced, as well as team and player data in near real-time. Each spring training game will be designated as full coverage, but only select games will feature pitch-by-pitch data.
In the event the MLB feed goes down or begins reporting errors, Sportradar takes over Live Data Entry (LDE) to provide a failover for MLB. During a failover, some data will not be available, and coverage is reduced to boxscore only. After the game is over data entered by Sportradar will be reconciled with the data provided by MLB.

☀️
Spring Training Coverage Note:
Due to varying game rules, limited on-site staff, and training of new on-venue statisticians, you may see data volatility (e.g. stat errors and prolonged game-closing process) for Spring Training games. As a result, there may be a higher than normal frequency of games with data latency or moving to fail-over mode throughout Spring Training.

Integration Links

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our MLB API collection. Please note that this collection is specific to the current version (v8).

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire MLB API XSD schema.

MLB v6 Schema