Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides stats and information pertaining to a competitor

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

⏱️

Update Frequency

300s Time To Live / Cache



Data Points

Competition:
AttributeParent ElementTypeDescription
gendercompetitionStringGender for a competition
men, women, mixed
idcompetitionStringUnique ID for a competition
ex. sr:competition:2555 (Wimbledon Men Singles)
levelcompetitionStringLevel of a competition
grand_slam, atp_1000, atp_500, atp_250, wta_premier, wta_international, atp_world_tour_finals, wta_championships, atp_next_generation, wta_elite_trophy, wta_master, wta_500, wta_250, wta_1000, wta_125
namecompetitionStringName of a competition
ex. Wimbledon Men Singles, WTA Monterrey, Mexico Women Doubles
parent_idcompetitionStringUnique parent ID for a competition.
ex. sr:competition:2553 is used to group all Wimbledon competitions.
typecompetitionStringType of a competition
ex. sings, doubles, mixed_doubles
Competitor:
AttributeParent ElementTypeDescription
abbreviationcompetitorStringAbbreviation for a competitor name
ex. PAU (Tommy Paul)
countrycompetitorStringCountry of a competitor
ex. USA
country_codecompetitorStringCountry code of a competitor
ex. USA
gendercompetitorStringGender for a competitor
male, female
idcompetitorStringUnique ID for a competitor
ex. sr:competitor:138546
namecompetitorStringName for a competitor
ex. Paul, Tommy
virtualcompetitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Competitor Info:
AttributeParent ElementTypeDescription
date_of_birthinfoDateDate of birth of a competitor
ex. 1997-05-17
handednessinfoStringHandedness for a competitor
right, left
heightinfoIntegerHeight of a competitor in centimeters
ex. 185
highest_doubles_rankinginfoIntegerHighest doubles ranking for a competitor
highest_doubles_ranking_dateinfoStringDate of the highest doubles ranking for a competitor
ex. 09.2022
highest_singles_rankinginfoIntegerHighest singles ranking for a competitor
highest_singles_ranking_dateinfoStringDate of the highest singles ranking for a competitor
ex. 10.2023
pro_yearinfoIntegerYear a competitor became a professional
weightinfoIntegerWeight of a player in kilograms
ex. 82
Competitor Rankings:
AttributeParent ElementTypeDescription
competitions_playedcompetitor_rankings - competitor_rankingIntegerNumber of competitions played for a competitor
competitor_idcompetitor_rankings - competitor_rankingStringUnique ID for a competitor
ex. sr:competitor:138546
movementcompetitor_rankings - competitor_rankingIntegerPosition change in a competitor's ranking from the previous week
ex. -1, 1
namecompetitor_rankings - competitor_rankingStringName of a competition for a competitor ranking
ex. ATP
pointscompetitor_rankings - competitor_rankingIntegerNumber of points for a competitor ranking
race_rankingcompetitor_rankings - competitor_rankingBooleanSignifies a competitor ranking is a race ranking when true
rankcompetitor_rankings - competitor_rankingIntegerCompetitor rank within a competitor ranking entry
typecompetitor_rankings - competitor_rankingStringType of a competitor ranking
ex. singles, doubles, mixed
Seasonal Statistics:

Competitor statistics are broken down by year and surface type

AttributeParent ElementTypeDescription
yearperiods - periodIntegerYear of competitor statistics
typeperiod - surfaceStringType of court surface
hard_court, grass, red_clay, green_clay, hardcourt_outdoor, carpet_indoor, synthetic_indoor, synthetic_outdoor, hardcourt_indoor, red_clay_indoor, unknown, synthetic_grass
competitions_playedsurface - statisticsIntegerNumber of competitions played for a year and surface type
competitions_wonsurface - statisticsIntegerNumber of competitions won for a year and surface type
matches_playedsurface - statisticsIntegerNumber of matches played for a year and surface type
matches_wonsurface - statisticsIntegerNumber of matches won for a year and surface type
Path Params
string
required
Defaults to trial

The access level of your API key

string
required
Defaults to v3

Version number of the API

string
required
Defaults to en

2 letter code for supported languages

de (German), en (English), es (Spanish), fr (French), id (Indonesian), it (Italian), ja (Japanese), ru (Russian), th (Thai), 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:competitor:89320

ID of a given competition

string
required
Defaults to json

Format returned

Response

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