Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Endpoints

🔐

Authorization

Place your API key in the header for each request (x-api-key)


Competitor Profile

Provides top-level information for a given team, including the full team roster, manager, home venue, and team colors.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/competitors/\{competitor_id}/profile.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

competitor_id

Id of a given competitor.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Competitor Results

Provides game info and scoring for the past 10 matches for a given team.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/competitors/\{competitor_id}/results.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

competitor_id

Id of a given competitor.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Competitor Schedule

Provides a list of scheduled games for a given team.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/competitors/\{competitor_id}/schedule.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

competitor_id

Id of a given competitor.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Daily Results

Provides all game results for a given date.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/schedules/{year}-{month}-{day}/results.\{format}

Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

year

Year in 4 digit format (YYYY).

month

Month in 2 digit format (MM).

day

Day in 2 digit format (DD).

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Daily Schedule

Provides a list of all scheduled games for a given date.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/schedules/{year}-{month}-{day}/schedule.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

year

Year in 4 digit format (YYYY).

month

Month in 2 digit format (MM).

day

Day in 2 digit format (DD).

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Head To Head

Provides previous and upcoming matches between two teams, including match results.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/competitors/\{competitor_id}/versus/{competitor_id2}/matches.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

competitor_id

Id of a given competitor.

competitor_id2

Id of a given competitor.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Player Profile

Provides biographical information for a given player.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/players/{player_id}/profile.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

player_id

Id of a given player.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Seasons

Provides a list of current and past season IDs for a given tournament. Season IDs can be interchanged with tournament IDs to retrieve historical data.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/tournaments/{tournament_id or season_id}/seasons.{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

tournament_id or season_id

Id of a given tournament or season.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Sport Event Probabilities

Provides 2-way probabilities (home team win, away team win) for a given game.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/matches/{match_id}/probabilities.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

match_id

Id of a given match.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Sport Event Timeline

Provides a scoring timeline for a given game. Please note that data returned is determined by coverage level.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/sport_events/{match_id}/timeline.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

match_id

Id of a given match.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Tournament Info

Provides information for a given tournament or season, including current season, participating teams, and tournament structure.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/tournaments/{tournament_id or season_id}/info.{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

tournament_id or season_id

Id of a given tournament or season.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Tournament List

Provides a list of all available tournaments in the API.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/tournaments.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Tournament Live Standings

Provides standings which are updated live according to games currently in progress. Note that not all tournaments or seasons are covered live.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/tournaments/{tournament_id or season_id}/live_standings.{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

tournament_id or season_id

Id of a given tournament or season.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Tournament Results

Provides results for all games within a given tournament or season.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/tournaments/{tournament_id or season_id}/results.{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

tournament_id or season_id

Id of a given tournament or season.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Tournament Schedule

Provides scheduling information for all games within a given tournament or season.

📘

Pagination

Pagination may be required to pull all data within this feed. By default, the feed will return 1000 sport events.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/tournaments/{tournament_id or season_id}/schedule.{format}

Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

tournament_id or season_id

Id of a given tournament or season.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.

Optional Query String Parameters

In addition to the URL parameters listed above, you can paginate the response with one or more of the following optional query string parameters. By default the limit is set to 1000.

Note: Optional query string parameters are added after your request with an ampersand (&).

Replace placeholders with the following query parameters:

ParameterDescription
startNumber to start the list of results from.
Example: start=0
limitNumber to limit the number of results. Minimum value is 1, maximum value is 1000.
Example: limit=75

Tournament Standings

Provides detailed standings info for a given season.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/tournaments/{tournament_id or season_id}/standings.{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

tournament_id or season_id

Id of a given tournament or season.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.


Venues

Provides information for a given venue, including capacity and map coordinates.

https://api.sportradar.com/baseball-\{access_level}\{version}/\{language_code}/venues/{venue_id}/summary.\{format}


Parameter

Description

access_level

Defines the access level of your API key as Production (p) or Trial (t).

version

Version number of the API you are accessing (Current Version: 1).

language_code

2 letter code for supported languages

Chinese - simplified (zh), Chinese - traditional (zht), English (en), Japanese (ja), Korean (ko), Spanish (es)

Click here for a tabular list of available languages per competition.

venue_id

Id of a given venue.

format

xml or json.

x-api-key

Your API key. Placed in the header of each request.