Season Players

get https://api.sportradar.com/soccer/{access_level}/v4/{language_code}/seasons/{season_id}/players.{format}

Provides names and ids for all participating players for a given season.

⏱️
Update Frequency
300s Time To Live / Cache

📘
Pagination Note
Pagination will often be required to pull all data within this feed. By default, the feed will return 1,000 players.

Data Points

Player:

Attribute	Parent Element	Type	Description
`country_code`	`player`	String	Country code of a player ex. `EGY` (Egypt)
`date_of_birth`	`player`	Date	Date of birth of a player ex. `1992-06-15`
`display_first_name`	`player`	String	Display first name of a player ex. `Mohamed`
`display_last_name`	`player`	String	Display last name of a player ex. `Salah`
`first_name`	`player`	String	Display last name of a player ex. `Mohamed Salah Hamed`
`gender`	`player`	String	Gender of a player `male`, `female`
`height`	`player`	Integer	Height of a player in centimeters ex. `175`
`id`	`player`	String	Unique ID of a player ex. `sr:player:159665`
`jersey_number`	`player`	Integer	Jersey number of a player
`last_name`	`player`	String	Last name of a player ex. `Mahrous Ghaly`
`name`	`player`	String	Name of a player ex. `Salah, Mohamed`
`nationality`	`player`	String	Nationality of a player ex. `Egypt`
`nickname`	`player`	String	Nickname of a player
`place_of_birth`	`player`	String	Place of birth of a player ex. `Basyoun, El Gharbia`
`type`	`player`	String	Position of a player `goalkeeper`, `defender`, `midfielder`, `forward`
`weight`	`player`	Integer	Weight of a player in kilograms ex. `71`

Path Params

access_level

string

required

Defaults to trial

The access level of your API key

language_code

string

required

Defaults to en

2 letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), id (Indonesian), it (Italian), ja (Japanese), nl (Dutch), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

season_id

string

required

Defaults to sr:season:118689

Id of a given season

format

string

required

Defaults to json

Format returned

Query Params

start

int32

Number to start the list of results from. Example: start=0

limit

int32

Number to limit the number of results. Minimum value is 1, maximum value is 1000. Example: limit=1000

Response

Language

Credentials

Query


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.sportradar.com/soccer/trial/v4/en/seasons/sr%3Aseason%3A118689/players.json \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Season Players

⏱️
Update Frequency

📘
Pagination Note

Data Points

⏱️Update Frequency

📘Pagination Note

Data Points

200200

⏱️
Update Frequency

📘
Pagination Note