search_players
Read-only
Use to find a player's id. Search by name (accents optional) and/or country code (e.g. ITA); most-played first, with matches, last match and rank on the current list (null outside ESPN's top 100 to 150). Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 1 credit.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Part of the player's name, e.g. "sinner". | |
| limit | No | Max players (default 20). | |
| league | No | League. Defaults to tennis. One of: tennis, wta. | |
| country | No | Three-letter country code, e.g. ESP. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tour | Yes | ||
| count | Yes | ||
| players | Yes |