Skip to content
SportsDataAPI Real-time sports data

Basketball API Documentation

v1.5.2 17 endpoints
https://v1.basketball.sportsdataapi.com

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.
GET https://v1.basketball.sportsdataapi.com/timezone

This endpoint does not require any query parameters.

Seasons

1 endpoint
GET /seasons seasons
All 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 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 id are unique in the API and leagues keep it across all seasons

This 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 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 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
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 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.
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 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
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 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 id can be used in endpoint odds as filters
GET 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.

Already have an account?