Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Seasonal Competitor Statistics

Soccer Extended Seasonal Competitor Statistics provides team and player seasonal statistics for a given season.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

30s Time To Live / Cache


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codeseason - categoryStringCountry code for a season's category

ex. ENG (England)
idseason - categoryStringUnique category ID for a season

ex. sr:category:1
nameseason - categoryStringName for a season's category

ex. England (Premier League)
idseason - sportStringUnique sport ID for a season

ex. sr:sport:1
nameseason - sportStringName for a season's sport

ex. Soccer
Competition
AttributeParent ElementTypeDescription
genderseason - competitionStringGender for a competition

ex. men
idseason - competitionStringUnique ID for a competition

ex. sr:competition:17 (Premier League)
nameseason - competitionStringName of a competition

ex. Premier League
parent_idseason - competitionStringUnique parent ID for a competition. Typically present for group stage or playoff competitions

ex. sr:competition:945 used to link competitions together, like the World Cup and the various qualifiers.
Season
AttributeParent ElementTypeDescription
competition_idseason_competitor_statistics - seasonStringUnique ID for the competition a season belongs to

ex. sr:competition:17 (Premier League)
disabledseason_competitor_statistics - seasonBooleanSignifies a season has been disabled when true
end_dateseason_competitor_statistics - seasonDateEnd date of a season

ex. 2024-05-19
idseason_competitor_statistics - seasonStringUnique ID for a season

ex. sr:season:105353 (Premier League 23/24)
nameseason_competitor_statistics - seasonStringName of a season

ex. Premier League 23/24
start_dateseason_competitor_statistics - seasonDateStart date of a season

ex. 2023-08-11
yearseason_competitor_statistics - seasonStringYear of a season

ex. 23/24
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitorStringAbbreviation for a competitor name

ex. LIV (Liverpool FC)
age_groupcompetitorStringAge group of a competitor, when applicable

ex. U23
countrycompetitorStringCountry of a competitor

ex. England
country_codecompetitorStringCountry code of a competitor

ex. ENG (England)
gendercompetitorStringGender for a competitor

male, female
idcompetitorStringUnique ID for a competitor

ex. sr:competitor:44 (Liverpool FC)
namecompetitorStringName for a competitor

ex. Liverpool FC
virtualcompetitorBooleanSignifies a competitor is a virtual team when true. Used for placeholder teams in TBD vs TBD matchups.
Player
AttributeParent ElementTypeDescription
idstatistics - competitor - playerStringUnique ID of a player

ex. sr:player:159665
namestatistics - competitor - playerStringName of a player

ex. Salah, Mohamed
Season Stats (Player)

See our Extended Statistics FAQ for in-depth definitions of key data points

AttributeParent ElementTypeDescription
assistsplayer - statisticsIntegerPlayer assists for a season
cards_givenplayer - statisticsIntegerPlayer cards received for a season
chances_createdplayer - statisticsIntegerPlayer chances created for a season
clean_sheetsplayer - statisticsIntegerPlayer clean sheets for a season
clearancesplayer - statisticsIntegerPlayer clearances for a season
corner_kicksplayer - statisticsIntegerPlayer corner kicks for a season
crosses_successfulplayer - statisticsIntegerPlayer successful crosses for a season
crosses_totalplayer - statisticsIntegerPlayer total crosses for a season
defensive_blocksplayer - statisticsIntegerPlayer defensive blocks for a season
dribbles_completedplayer - statisticsIntegerPlayer dribbles completed for a season
fouls_committedplayer - statisticsIntegerPlayer fouls committed for a season
fouls_wonplayer - statisticsIntegerPlayer fouls committed for a season
goals_by_headplayer - statisticsIntegerPlayer goals by head scored for a season
goals_by_penaltyplayer - statisticsIntegerPlayer goals by penalty scored for a season
goals_concededplayer - statisticsIntegerPlayer goals conceded for a season
goals_scoredplayer - statisticsIntegerPlayer goals scored for a season
interceptionsplayer - statisticsIntegerPlayer interceptions for a season
long_passes_successfulplayer - statisticsIntegerPlayer successful long passes for a season
long_passes_totalplayer - statisticsIntegerPlayer total long passes for a season
long_passes_unsuccessfulplayer - statisticsIntegerPlayer unsuccessful long passes for a season
loss_of_possessionplayer - statisticsIntegerPlayer possession losses for a season
matches_playedplayer - statisticsIntegerNumber of matches played by a player for a season
minutes_playedplayer - statisticsIntegerNumber of minutes played by a player for a season
offsidesplayer - statisticsIntegerPlayer offsides for a season
own_goalsplayer - statisticsIntegerPlayer own goals for a season
passes_successfulplayer - statisticsIntegerPlayer successful passes for a season
passes_totalplayer - statisticsIntegerPlayer total passes for a season
passes_unsuccessfulplayer - statisticsIntegerPlayer unsuccessful passes for a season
penalties_missedplayer - statisticsIntegerPlayer penalty shots missed for a season
penalties_savedplayer - statisticsIntegerPlayer penalty shots saved for a season
red_cardsplayer - statisticsIntegerPlayer red cards for a season
shots_blockedplayer - statisticsIntegerPlayer shots blocked for a season
shots_off_targetplayer - statisticsIntegerPlayer shots off target for a season
shots_on_targetplayer - statisticsIntegerPlayer shots on target for a season
substituted_inplayer - statisticsIntegerNumber of times a player is substituted in for a season
substituted_outplayer - statisticsIntegerNumber of times a player is substituted out for a season
tackles_successfulplayer - statisticsIntegerPlayer successful tackles for a season
tackles_totalplayer - statisticsIntegerPlayer total tackles for a season
yellow_cardsplayer - statisticsIntegerPlayer yellow cards for a season
yellow_red_cardsplayer - statisticsIntegerPlayer red cards for a match resulting from two yellow cards
Season Stats (Team)

See our Extended Statistics FAQ for in-depth definitions of key data points

AttributeParent ElementTypeDescription
average_ball_possessioncompetitor - statisticsFloatPercentage of team ball possession for a season

ex. 65.53
cards_givencompetitor - statisticsIntegerTotal cards given to a team in a season
chances_createdcompetitor - statisticsIntegerTotal chances created for a team in a season
clearancescompetitor - statisticsIntegerTotal clearances for a team in a season
corner_kickscompetitor - statisticsIntegerTotal team corner kicks for a season
crosses_successfulcompetitor - statisticsIntegerTotal team successful crosses for a season
crosses_totalcompetitor - statisticsIntegerTotal team crosses for a season
crosses_unsuccessfulcompetitor - statisticsIntegerTotal team unsuccessful crosses for a season
defensive_blockscompetitor - statisticsIntegerTotal defensive blocks for a team in a season
diving_savescompetitor - statisticsIntegerTotal diving saves for a team in a season
dribblescompetitor - statisticsIntegerTotal dribbles for a team in a season
free_kickscompetitor - statisticsIntegerTeam free kicks for a season. In accordance with the rules, a free kick stat is counted for the team who executes a free kick. Direct or indirect free kicks are all counted as free kicks.
goals_by_footcompetitor - statisticsIntegerTeam goals scored by foot for a season
goals_by_headcompetitor - statisticsIntegerTeam goals scored by head for a season
goals_concededcompetitor - statisticsIntegerTeam goals conceded for a season
goals_conceded_first_halfcompetitor - statisticsIntegerTeam goals conceded in the first half for a season
goals_conceded_second_halfcompetitor - statisticsIntegerTeam goals conceded in the second half for a season
goals_scoredcompetitor - statisticsIntegerTotal team goals scored for a season
goals_scored_first_halfcompetitor - statisticsIntegerTotal team goals scored in the first half for a season
goals_scored_second_halfcompetitor - statisticsIntegerTotal team goals scored in the second half for a season
interceptionscompetitor - statisticsIntegerTotal interceptions for a team in a season
long_passes_successfulcompetitor - statisticsIntegerTotal team successful long passes for a season
long_passes_totalcompetitor - statisticsIntegerTotal team long passes for a season
long_passes_unsuccessfulcompetitor - statisticsIntegerTotal team unsuccessful long passes for a season
loss_of_possessioncompetitor - statisticsIntegerTotal team possession losses for a season
matches_playedcompetitor - statisticsIntegerNumber of matches played for a team in a season
offsidescompetitor - statisticsIntegerTotal team offside infringements for a season
passes_successfulcompetitor - statisticsIntegerTotal team successful passes for a season
passes_totalcompetitor - statisticsIntegerTotal team passes for a season
passes_unsuccessfulcompetitor - statisticsIntegerTotal team unsuccessful passes for a season
penalties_missedcompetitor - statisticsIntegerTotal team penalty shots missed for a season
red_cardscompetitor - statisticsIntegerTotal team red cards for a season
shots_blockedcompetitor - statisticsIntegerTotal team shots blocked for a season
shots_off_targetcompetitor - statisticsIntegerTotal team off-target shots for a season
shots_on_barcompetitor - statisticsIntegerTotal team on-bar shots for a season
shots_on_postcompetitor - statisticsIntegerTotal team on-post shots for a season
shots_on_targetcompetitor - statisticsIntegerTotal team on-target shots for a season
shots_totalcompetitor - statisticsIntegerTotal number of shots attributed to a team for a season
tackles_successfulcompetitor - statisticsIntegerTotal team successful tackles for a season
tackles_totalcompetitor - statisticsIntegerTotal team tackles for a season
tackles_unsuccessfulcompetitor - statisticsIntegerTotal team unsuccessful tackles for a season
was_fouledcompetitor - statisticsIntegerTotal number of fouls against a team in a season
yellow_cardscompetitor - statisticsIntegerTotal team yellow cards for a season
yellow_red_cardscompetitor - statisticsIntegerTotal team red cards for a season which resulted from two yellow cards
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
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.

string
required
Defaults to sr:season:130281

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:118689

string
required
Defaults to sr:competitor:17

Unique Id of a competitor participating in a season, found in the Season Competitors endpoint

Example: sr:competitor:17

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json