Skip to main content
GET
Top Players

Endpoint

Description

Returns the top athletes (players) sorted by popularity, along with related sports, countries, and competitions data. Useful for featuring popular players on dashboards and discovery pages.

Parameters

Parameters marked as “auto-resolved” are automatically determined based on request context. You can override timezoneName with a specific timezone (e.g., America/New_York). All date/time fields use ISO 8601 format with a dynamic timezone offset.

Request

Response

Response Fields

Root Level

Athlete Object

Position Object

Formation Position Object

Position Types

Football Positions

Formation Positions (Football)

Top Football Players

Athlete Images

Athlete photos can be accessed via the images proxy:
Example:

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[]
Last modified on June 29, 2026