get_rankings
Read-only
Use for the ranking list: the latest (default), or a season and week, or the list in force on a date, with rank, previous rank, points and player. Pass player_id instead for one player's ranking history. ESPN keeps the top 100 to 150 for most weeks since 2007. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | The list in force on this date, YYYY-MM-DD. | |
| week | No | Week number of the season. | |
| limit | No | Max rows of a list (default 100). | |
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| season | No | Year. | |
| player_id | No | One player's ranking history instead of a list. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| tour | Yes | ||
| week | No | ||
| count | Yes | ||
| season | No | ||
| history | No | ||
| rankings | No | ||
| best_rank | No | ||
| player_id | No | ||
| ranking_date | No |