Players - AnySport

Returns soccer player profiles (a current snapshot of current team, shirt number, age, position, etc.), supporting lookup by:

player_id for a single player,
by team_id for a full team roster,
or fuzzy search by player_name

(Provide any one of above. ) Suitable for the “Player Roster” section of a team details page or a player search box. If league_id is also provided, the response additionally includes the player’s cumulative technical stats for that league’s current season, season_stats (appearances/goals/assists/rating, etc.), which can be used to display technical stats on a player card; if omitted, only basic profile information is returned.

Endpoint

GET /v1/soccer/players

Parameters

At least one of player_id / team_id / player_name must be provided.

Parameter	Type	Required	Description
`player_id`	string	One of these required	Player ID (`asp_`)
`team_id`	string	One of these required	Query a team’s roster (`ast_`)
`player_name`	string	One of these required	Fuzzy search by name
`league_id`	string	No	Additional league filter; also used to populate `season_stats` (see response fields)
`season`	string	No	Currently has no effect (neither the player’s basic profile nor season stats have a season dimension, so this parameter is ignored); reserved for future use
`lang`	string	No	`en` / `zh-CN`; invalid values silently fall back to the default language — see `GET /languages` (19) for available values

A player’s basic profile is a current snapshot (the player’s current team/number/age). When league_id is provided, the cumulative current-season stats season_stats for that league are additionally returned.

Response fields (data: array)

Field	Type	Description
`player_id`	string	Player ID (`asp_` prefix)
`name`	string	Name
`nationality`	string	Nationality
`position`	string	Position, see “Enum reference: position” below
`number`	string	Shirt number
`age`	string	Age
`team_id`	string	ID of the team the player belongs to
`team_name`	string	Name of the team the player belongs to
`season_stats`	object	Cumulative current-season stats, returned only when `league_id` is provided and data exists: `{ league_id, appearances, minutes, goals, assists, yellow_cards, red_cards, rating }`

Enum reference: position

Value	Meaning
`G`	Goalkeeper
`D`	Defender
`M`	Midfielder
`F`	Forward

Request example

GET /v1/soccer/players?team_id=ast_9137ee449e3b40a68149ca319373adaf&lang=en

Response example

Player profile response example (excerpt)

{
  "success": true,
  "data": [
    {
      "player_id": "asp_1dca6c7e13f44cceae622530c551ad15",
      "name": "Alexis Mac Allister",
      "position": "M",
      "number": "20",
      "age": "27",
      "team_id": "ast_9137ee449e3b40a68149ca319373adaf",
      "team_name": "Argentina"
    },
    {
      "player_id": "asp_6f890f89feb54c82b38c46ddd89b8a1e",
      "name": "Emiliano Martinez",
      "position": "G",
      "number": "23",
      "age": "33",
      "team_id": "ast_9137ee449e3b40a68149ca319373adaf",
      "team_name": "Argentina"
    }
  ],
  "meta": {
    "total": 13,
    "timestamp": "2026-07-13T19:18:23.402122900Z"
  },
  "traceId": "3c7c05ec-c4c8-44ed-ac01-9f7e3367c3fe"
}

​Endpoint

​Parameters

​Response fields (data: array)

​Enum reference: position

​Request example

​Response example

Endpoint

Parameters

Response fields (data: array)

Enum reference: position

Request example

Response example