Top Players

Get top basketball players and player statistics

GET /athletes/top

Top Players

cURL

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

200

{
  "athletes": [
    {
      "id": 123,
      "name": "<string>",
      "firstName": "<string>",
      "lastName": "<string>",
      "position": "<string>",
      "team": {
        "id": 123,
        "name": "<string>",
        "score": 123,
        "imageUrl": "<string>"
      },
      "imageUrl": "<string>",
      "stats": {
        "pointsPerGame": 123,
        "reboundsPerGame": 123,
        "assistsPerGame": 123,
        "gamesPlayed": 123
      }
    }
  ]
}

Overview

Returns top basketball players for a competition, including season statistics like points per game, rebounds, and assists.

Note: For the most accurate basketball player results, use the /stats endpoint with a specific competitionId (e.g., 132 for NBA) to get statistical leaders, or use /search with filter=athletes to find specific players.

Query Parameters

competitionId · integer · required

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

limit · integer

Number of players to return (default: 10)

Recommended Approach

For finding top basketball players, we recommend using the /stats endpoint which returns statistical leaders:

cURL - Stats Endpoint (Recommended)

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

Code Examples (Athletes Endpoint)

cURL

curl -X GET "https://v1.basketball.sportsapipro.com/athletes/top?competitionId=132" \
  -H "x-api-key: YOUR_API_KEY"

Response Structure

athletes · array

Array of top players

Show Athlete Object

id · integer

Player ID

name · string

Full name

firstName · string

First name

lastName · string

Last name

position · string

Position (PG, SG, SF, PF, C)

team · object

Current team (id, name)

imageUrl · string

Player photo URL

stats · object

Season statistics

Show Stats

pointsPerGame · number

Points per game

reboundsPerGame · number

Rebounds per game

assistsPerGame · number

Assists per game

gamesPlayed · integer

Games played

Example Response

{
  "athletes": [
    {
      "id": 12345,
      "name": "LeBron James",
      "firstName": "LeBron",
      "lastName": "James",
      "position": "SF",
      "team": {
        "id": 678,
        "name": "Los Angeles Lakers"
      },
      "imageUrl": "...",
      "stats": {
        "pointsPerGame": 28.5,
        "reboundsPerGame": 8.2,
        "assistsPerGame": 7.1,
        "gamesPlayed": 45
      }
    }
  ]
}

Related Endpoints

• /stats - Get statistical leaders for a competition (recommended)
• /search - Search for specific players by name
• /athletes/games - Get game-by-game stats for a player

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

competitionId · integer · required

Competition ID

Example:

132

Response

200 - application/json

Top athletes retrieved successfully

athletes · object[]

Show child attributes