get_ratings
Read-only
Use for our Elo ratings, highest first: overall, or on one surface (hard, clay, grass). Players with a rated match since active_since (default a year ago) and at least 10 rated matches. 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 |
|---|---|---|---|
| limit | No | Max players (default 50). | |
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| surface | No | Rank by the surface rating instead of overall. | |
| active_since | No | Only players with a rated match since this date, YYYY-MM-DD (default one year ago). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tour | Yes | ||
| count | Yes | ||
| method | Yes | ||
| ratings | Yes | ||
| surface | Yes | ||
| active_since | Yes |