Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides stats and information pertaining to a competitor

⏱️

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
Language
Authorization
Query
Click Try It! to start a request and see the response here!