Competition Statistics

Get statistical leaders for basketball competitions

GET /stats

Competition Statistics

cURL

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

Overview

Returns statistical leaders for a basketball competition, including top scorers, rebounders, assisters, and other key metrics.

Query Parameters

competitions · integer · required

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

competitors · integer

Filter statistics by team ID

withSeasons · boolean

Include season information

Code Examples

cURL

curl -X GET "https://v1.basketball.sportsapipro.com/stats?competitions=132&withSeasons=true" \
  -H "x-api-key: YOUR_API_KEY"

Response Structure

categories · array

Statistical categories with leaders

Show Category Object

id · integer

Category identifier

name · string

Category name (Points, Rebounds, Assists, etc.)

leaders · array

Top players in this category

Show Leader Object

athlete · object

Player details (id, name, team, imageUrl)

value · number

Statistical value (e.g., PPG, RPG)

rank · integer

League ranking

gamesPlayed · integer

Games played

season · object

Current season information (when withSeasons=true)

Example Response

{
  "categories": [
    {
      "id": 1,
      "name": "Points",
      "leaders": [
        {
          "athlete": {
            "id": 12345,
            "name": "Luka Dončić",
            "team": {
              "id": 2800,
              "name": "Dallas Mavericks"
            },
            "imageUrl": "..."
          },
          "value": 33.5,
          "rank": 1,
          "gamesPlayed": 45
        }
      ]
    },
    {
      "id": 2,
      "name": "Rebounds",
      "leaders": [...]
    },
    {
      "id": 3,
      "name": "Assists",
      "leaders": [...]
    }
  ],
  "season": {
    "id": 2025,
    "name": "2025-26 Season",
    "isCurrent": true
  }
}

Statistical Categories

Common basketball statistical categories:

Category	Description
Points	Points per game (PPG)
Rebounds	Rebounds per game (RPG)
Assists	Assists per game (APG)
Steals	Steals per game (SPG)
Blocks	Blocks per game (BPG)
Field Goal %	Shooting percentage
3-Point %	Three-point percentage
Free Throw %	Free throw percentage

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

competitions · integer · required

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

Example:

132

competitors · integer

Filter by team ID

withSeasons · boolean · default: false

Include season information

Response

200

Statistics retrieved successfully