Basketball API Reference

Complete reference for Basketball API endpoints

GET /status

Account Status

cURL

curl --request GET \
  --url https://v1.basketball.sportsapipro.com/status \
  --header 'x-api-key: <api-key>'

⚠️ Deprecated — This is the V1 Legacy API. It still works but is no longer maintained. We strongly recommend migrating to the Basketball V2 API for improved coverage, richer data, and support for 25+ sports.

Overview

The Basketball API provides comprehensive data for 50+ basketball leagues worldwide. All endpoints use the same authentication and follow consistent response patterns.

Base URL: https://v1.basketball.sportsapipro.com

The sports=2 parameter is automatically added to all requests.

Authentication

All endpoints require authentication via the x-api-key header:

cURL

curl -X GET "https://v1.basketball.sportsapipro.com/games/current" \
  -H "x-api-key: YOUR_API_KEY"

Available Endpoints

Games & Scores

Endpoint	Method	Description
/games/current	GET	Live basketball games
/games/fixtures	GET	Upcoming games
/games/results	GET	Completed games
/game	GET	Single game details
/games/h2h	GET	Head-to-head history
/games/stats	GET	Game statistics

Competitions

Endpoint	Method	Description
/competitions	GET	List competitions
/competitions/top	GET	Top leagues by popularity
/competitions/featured	GET	Featured competitions

Standings

Endpoint	Method	Description
/standings	GET	League standings

Athletes

Endpoint	Method	Description
/athletes/top	GET	Top players
/athletes/games	GET	Player game logs
/athletes/nextGame	GET	Player’s next game

Betting

Endpoint	Method	Description
/bets/lines	GET	Betting lines
/bets/proposition	GET	Player props
/trends	GET	Betting trends
/predictions	GET	Game predictions

Other

Endpoint	Method	Description
/status	GET	Account status & usage
/search	GET	Search entities
/competitors/top	GET	Top teams

Common Parameters

competitions · integer

Competition ID (e.g., 132 for NBA)

gameId · integer

Specific game ID for detailed endpoints

athleteId · integer

Specific player ID for athlete endpoints

date · string

Date filter in YYYY-MM-DD format

lastUpdateId · integer

For efficient polling - returns only updates since this ID

Response Format

All responses follow this structure:

{
  "games": [...],
  "lastUpdateId": 987654,
  "ttl": 5
}

lastUpdateId · integer

Use this value in subsequent requests for efficient polling

ttl · integer

Suggested cache time-to-live in seconds

Rate Limits

Rate limits are shared across all sports APIs:

Plan	Requests/Day
Free	100
Pro	7,500
Ultra	75,000
Mega	150,000

Key Competition IDs

Competition	ID	Country
NBA	132	USA
WNBA	2004	USA
EuroLeague	138	Europe
NCAA Men’s	2065	USA
Spanish ACB	149	Spain
Turkish BSL	150	Turkey

Error Handling

All errors follow a consistent format with HTTP status codes and descriptive messages.

Status	Description
400	Bad Request - Missing required parameters
401	Unauthorized - Invalid or missing API key
429	Rate Limited - Too many requests
500	Server Error - Try again later

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Response

200

Account status retrieved successfully