Skip to main content
GET
/
athletes
/
top
Top Players
curl --request GET \
  --url https://v1.basketball.sportsapipro.com/athletes/top \
  --header 'x-api-key: <api-key>'
{
  "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)
For finding top basketball players, we recommend using the /stats endpoint which returns statistical leaders: 
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 -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

​
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
      }
    }
  ]
}
  • /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[]