get_surface_splits
Read-only
Use for a player's record by surface (hard, clay, grass, carpet): wins, losses, win rate, sets, share of games won, tiebreaks, deciding sets and 6-0 sets, plus the current surface ratings. For one season or the whole career; by_season splits each surface by year. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| season | No | Year (default the whole career). | |
| by_season | No | Split each surface by season. | |
| player_id | Yes | Player id from search_players. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| tour | Yes | ||
| season | Yes | ||
| splits | Yes | ||
| overall | Yes | ||
| ratings | Yes | ||
| player_id | Yes |