REST API v1.0 Resources

Players

Information about the players who played for a team during a given year. Regular season games, post-season games, and all-star games are all separate, and can be specified with the game_type parameter.

Resource Description
GET players Returns a list of players for a team/season.

Games

Game information, including score, park/attendance, line score, statistical totals, lineups, umpires, and more.

Resource Description
GET games Returns a list of games that meet the search criteria.
GET games/summary Returns a summary of games that meet the search criteria.
GET games/for_team Returns a list of a team's games that meet the search criteria.
GET games/for_team/summary Returns a summary of a team's games that meet the search criteria.

Events

Information for every at-bat, including a multitude of factors such as: the batter and pitcher who were involved, the result of the at-bat, the positioning of the baserunners, the positions of the defenders, the count, and much more.

Resource Description
GET events Returns a list of events that meet the search criteria.
GET events/summary Returns a summary of at-bats/events that meet the search criteria.

Teams

Information regarding which teams participated in each season.

Resource Description
GET teams Returns a list of all teams for a specific year.

Franchises

Information about each of the 30 current major league franchises, including location changes, name changes, etc.

Resource Description
GET franchises Returns a list of all franchises.
GET franchises/:id Returns the details of a single franchise, including a list of the years in which the franchise has been in operation.

Standings

Returns a snapshot of the standings on a specified date or over a period of time.

Resource Description
GET standings Search the standings
GET standings/snapshot Returns a snapshot of the standings as of the end of the specified date.

Schedules

Information regarding the initial published schedule for each season. Many of the games would have been postponed for various reasons, and these changes are not reflected in this data. For information regarding games that actually took place, please use the 'games' service.

Resource Description
GET schedules Returns a list of all scheduled games.

Seasons

Information regarding which seasons have available data.

Resource Description
GET seasons Returns a list of all seasons for which data is available.

Parks

Information regarding ballparks that have been used over the years.

Resource Description
GET parks Returns a list of all ballparks.

Opponents

Information about the hitters that a pitcher faced or the pitchers that a hitter faced for a given set of criteria.

Resource Description
GET opponents/pitchers Returns a list of the pitchers that the specified batter/team has faced.
GET opponents/batters Returns a list of the batters that the specified pitcher/team has faced.