Basketball API Documentation
v1.5.2 17 endpoints
https://v1.basketball.sportsdataapi.com Endpoints
Timezone
1 endpoint GET /timezone timezone
Get the list of available timezone to be used in the games endpoint.
This endpoint does not require any parameters.
This endpoint does not require any parameters.
GET https://v1.basketball.sportsdataapi.com/timezone This endpoint does not require any query parameters.
Seasons
1 endpoint GET /seasons seasons
All
This endpoint does not require any parameters.
seasons can be used in other endpoints as filters.This endpoint does not require any parameters.
GET https://v1.basketball.sportsdataapi.com/seasons This endpoint does not require any query parameters.
Countries
1 endpoint GET /countries countries
Get the list of available countries.
The
All the parameters of this endpoint can be used together.
The
id name and code fields can be used in other endpoints as filters. All the parameters of this endpoint can be used together.
GET https://v1.basketball.sportsdataapi.com/countries Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the country | |
| name | string | The name of the country | |
| code | string | The code of the country | |
| search | string |
Leagues
1 endpoint GET /leagues leagues
Get the list of available leagues and cups.
The league
This endpoint also returns the
The values returned by the coverage indicate the data available at the moment you call the API, so for a competition that has not yet started, it is normal to have all the features set to False. This will be updated once the competition has started.
The coverage of a competition can vary from season to season and values set to
You can find all the leagues ids on our [Dashboard](https://dashboard.sportsdataapi.com/basketball/ids).
Most of the parameters of this endpoint can be used together.
The league
id are unique in the API and leagues keep it across all seasonsThis endpoint also returns the
coverage of each competition, which makes it possible to know what is available for leagues or cups.The values returned by the coverage indicate the data available at the moment you call the API, so for a competition that has not yet started, it is normal to have all the features set to False. This will be updated once the competition has started.
The coverage of a competition can vary from season to season and values set to
True do not guarantee 100% data availability.You can find all the leagues ids on our [Dashboard](https://dashboard.sportsdataapi.com/basketball/ids).
Most of the parameters of this endpoint can be used together.
GET https://v1.basketball.sportsdataapi.com/leagues Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the league | |
| name | string | The name of the league | |
| country_id | integer | The id of the country | |
| country | string | The name of the country | |
| type | string | The type of the league leaguecup | |
| season | string | The season of the league | |
| search | string | The name of the league | |
| code | string | The code of the country |
Teams
2 endpoints GET /teams teams
Get data about teams.
The team
You can find all the teams ids on our [Dashboard](https://dashboard.sportsdataapi.com/basketball/ids/teams).
This endpoint requires at least one parameter.
The team
id are unique in the API and teams keep it among all the leagues/cups in which they participate.You can find all the teams ids on our [Dashboard](https://dashboard.sportsdataapi.com/basketball/ids/teams).
This endpoint requires at least one parameter.
GET https://v1.basketball.sportsdataapi.com/teams Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the team | |
| name | string | The name of the team | |
| country_id | integer | The id of the country | |
| country | string | The name of the country | |
| league | integer | The id of the league | |
| season | string | The season of the league | |
| search | string | The name of the team |
GET /statistics statistics
GET https://v1.basketball.sportsdataapi.com/statistics Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | integer | The id of the league | |
| season | string | The season of the league | |
| team | integer | The id of the team | |
| date | string | A Limit Date |
Players
1 endpoint GET /players players
Get data about players.
The players
This endpoint requires at least one parameter.
The players
id are unique in the API and players keep it among all the leagues/cups in which they participate.This endpoint requires at least one parameter.
GET https://v1.basketball.sportsdataapi.com/players Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the player | |
| team | integer | The id of the team | |
| season | string | A valid season | |
| search | string | The name of the player |
Standings
3 endpoints GET /standings standings
Get the standings for a league.
Return a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, regular season, pre season etc…
To know the list of available stages or groups you have to use the endpoint standings/stages or standings/groups
Standings are updated every hours
Return a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, regular season, pre season etc…
To know the list of available stages or groups you have to use the endpoint standings/stages or standings/groups
Standings are updated every hours
GET https://v1.basketball.sportsdataapi.com/standings Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | integer | The id of the league | |
| season | string | The season of the league | |
| team | integer | The id of the team | |
| stage | string | A valid stage | |
| group | string | A valid group |
GET /standings/stages standings/stages
Get the list of available stages for a league to be used in the standings endpoint.
GET https://v1.basketball.sportsdataapi.com/standings/stages Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | integer | The id of the league | |
| season | string | The season of the league |
GET /standings/groups standings/groups
Get the list of available groups for a league to be used in the standings endpoint.
GET https://v1.basketball.sportsdataapi.com/standings/groups Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | integer | The id of the league | |
| season | string | The season of the league |
Games
4 endpoints GET /games games
For all requests to games you can add the query parameter
To know the list of available time zones you have to use the endpoint timezone
Available status * NS : Not Started * Q1 : Quarter 1 (In Play) * Q2 : Quarter 2 (In Play) * Q3 : Quarter 3 (In Play) * Q4 : Quarter 4 (In Play) * OT : Over Time (In Play) * BT : Break Time (In Play) * HT : Halftime (In Play) * FT : Game Finished (Game Finished) * AOT : After Over Time (Game Finished) * POST : Game Postponed * CANC : Game Cancelled * SUSP : Game Suspended * AWD : Game Awarded * ABD : Game Abandoned
Games are updated every 15 seconds
This endpoint requires at least one parameter.
timezone to your request in order to retrieve the list of games in the time zone of your choice like *“Europe/London“*To know the list of available time zones you have to use the endpoint timezone
Available status * NS : Not Started * Q1 : Quarter 1 (In Play) * Q2 : Quarter 2 (In Play) * Q3 : Quarter 3 (In Play) * Q4 : Quarter 4 (In Play) * OT : Over Time (In Play) * BT : Break Time (In Play) * HT : Halftime (In Play) * FT : Game Finished (Game Finished) * AOT : After Over Time (Game Finished) * POST : Game Postponed * CANC : Game Cancelled * SUSP : Game Suspended * AWD : Game Awarded * ABD : Game Abandoned
Games are updated every 15 seconds
This endpoint requires at least one parameter.
GET https://v1.basketball.sportsdataapi.com/games Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game | |
| date | string | A valid date | |
| league | integer | The id of the league | |
| season | string | The season of the league | |
| team | integer | The id of the team | |
| timezone | string | A valid timezone |
GET /games/statistics/teams teams statistics
Get teams statistics from one or several games ids.
Statistics are updated every 30-120 seconds
This endpoint need at least one parameter.
Statistics are updated every 30-120 seconds
This endpoint need at least one parameter.
GET https://v1.basketball.sportsdataapi.com/games/statistics/teams Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | The id of the game | |
| ids | string | One or more games ids id-id-id |
GET /games/statistics/players players statistics
Get players statistics from one or several games ids.
Also possible to get all statistics from a player
Statistics are updated every 30-120 seconds
This endpoint need at least one parameter.
Also possible to get all statistics from a player
id and a season.Statistics are updated every 30-120 seconds
This endpoint need at least one parameter.
GET https://v1.basketball.sportsdataapi.com/games/statistics/players Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | The id of the game | |
| ids | string | One or more games ids id-id-id | |
| player | integer | The id of the player | |
| season | string | A valid season |
GET /games/h2h h2h
Get heads to heads between two teams.
GET https://v1.basketball.sportsdataapi.com/games/h2h Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| h2h | string | The ids of the teams | |
| date | string | A valid date | |
| league | integer | The id of the league | |
| season | string | The season of the league | |
| timezone | string | A valid timezone |
Odds
3 endpoints GET /odds odds
Get odds from games or leagues.
We provide pre-match odds between 1 and 7 days before the game.
We keep a 7-day history *(The availability of odds may vary according to the leagues, seasons, games and bookmakers)*
Odds are updated once a day
We provide pre-match odds between 1 and 7 days before the game.
We keep a 7-day history *(The availability of odds may vary according to the leagues, seasons, games and bookmakers)*
Odds are updated once a day
GET https://v1.basketball.sportsdataapi.com/odds Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | integer | The id of the league | |
| season | string | The season of the league | |
| game | integer | The id of the game | |
| bookmaker | integer | The id of the bookmaker | |
| bet | integer | The id of the bet |
GET /bookmakers bookmakers
Get all available bookmakers.
All bookmakers
All bookmakers
id can be used in endpoint odds as filters.GET https://v1.basketball.sportsdataapi.com/bookmakers Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the bookmaker | |
| search | string | The name of the bookmaker |
GET /bets bets
Get all available bets.
All bets
All bets
id can be used in endpoint odds as filtersGET https://v1.basketball.sportsdataapi.com/bets Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the bet | |
| search | string | The name of the bet |
Quick Reference
Base URL
https://v1.basketball.sportsdataapi.com Authentication
x-apisports-key: YOUR_API_KEY cURL
curl -X GET "https://v1.basketball.sportsdataapi.com/timezone" \
-H "x-apisports-key: YOUR_API_KEY" Start free. Scale when ready.
Get 100 free basketball API requests per day. No credit card required.
Upgrade to PRO for full real-time data, live odds, and unlimited historical access.