Competitor Profile

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL/Cache: 300 seconds
Data Updates (Tier 1): Player data check two weeks before competition start

📘
Building Player Views
Learn how to use the Competitor Profile to enrich ranking rows with player details in our Retrieving Rankings and Standings integration scenario.

Data Points

Competition

Attribute	Parent Element	Type	Description
`gender`	`competition`	String	Gender for a competition `men`, `women`, `mixed`, `female`, `male`
`id`	`competition`	String	Unique ID for a competition ex. `sr:competition:2555` (Wimbledon Men Singles)
`level`	`competition`	String	Level 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`
`name`	`competition`	String	Name of a competition ex. `Wimbledon Men Singles`, `WTA Monterrey, Mexico Women Doubles`
`parent_id`	`competition`	String	Unique parent ID for a competition. ex. `sr:competition:2553` is used to group all Wimbledon competitions.
`type`	`competition`	String	Type of a competition ex. `singles`, `doubles`, `mixed`, `mixed_doubles`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitor`	String	Abbreviation for a competitor name ex. `PAU` (Tommy Paul)
`country`	`competitor`	String	Country of a competitor ex. `USA`
`country_code`	`competitor`	String	Country code of a competitor ex. `USA`
`gender`	`competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitor`	String	Unique ID for a competitor ex. `sr:competitor:138546`
`name`	`competitor`	String	Name for a competitor ex. `Paul, Tommy`
`virtual`	`competitor`	Boolean	Signifies a competitor is virtual when `true`. Used for placeholder players/teams in TBD vs TBD matchups.

Competitor Info

Attribute	Parent Element	Type	Description
`date_of_birth`	`info`	Date	Date of birth of a competitor ex. `1997-05-17`
`handedness`	`info`	String	Handedness for a competitor `right`, `left`
`height`	`info`	Integer	Height of a competitor in centimeters ex. `185`
`highest_doubles_ranking`	`info`	Integer	Highest doubles ranking for a competitor
`highest_doubles_ranking_date`	`info`	String	Date of the highest doubles ranking for a competitor ex. `09.2022`
`highest_singles_ranking`	`info`	Integer	Highest singles ranking for a competitor
`highest_singles_ranking_date`	`info`	String	Date of the highest singles ranking for a competitor ex. `10.2023`
`pro_year`	`info`	Integer	Year a competitor became a professional
`weight`	`info`	Integer	Weight of a player in kilograms ex. `82`

Competitor Rankings

Attribute	Parent Element	Type	Description
`competitions_played`	`competitor_rankings` - `competitor_ranking`	Integer	Number of competitions played for a competitor
`competitor_id`	`competitor_rankings` - `competitor_ranking`	String	Unique ID for a competitor ex. `sr:competitor:138546`
`movement`	`competitor_rankings` - `competitor_ranking`	Integer	Position change in a competitor's ranking from the previous week ex. `-1`, `1`
`name`	`competitor_rankings` - `competitor_ranking`	String	Name of a competition for a competitor ranking ex. `ATP`
`points`	`competitor_rankings` - `competitor_ranking`	Integer	Number of points for a competitor ranking
`race_ranking`	`competitor_rankings` - `competitor_ranking`	Boolean	Signifies a competitor ranking is a race ranking when `true`
`rank`	`competitor_rankings` - `competitor_ranking`	Integer	Competitor rank within a competitor ranking entry
`type`	`competitor_rankings` - `competitor_ranking`	String	Type of a competitor ranking ex. `singles`, `doubles`, `mixed`

Seasonal Statistics

Competitor statistics are broken down by year and surface type

Attribute	Parent Element	Type	Description
`year`	`periods` - `period`	Integer	Year of competitor statistics
`type`	`period` - `surface`	String	Type 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_played`	`surface` - `statistics`	Integer	Number of competitions played for a year and surface type
`competitions_won`	`surface` - `statistics`	Integer	Number of competitions won for a year and surface type
`matches_played`	`surface` - `statistics`	Integer	Number of matches played for a year and surface type
`matches_won`	`surface` - `statistics`	Integer	Number of matches won for a year and surface type

Update Frequency

Building Player Views

Data Points

200200