GET
https://api.tennisdatabaseapi.com/v1/playersEvery planFind players by name.
Free key includedLive includedArchive includedComplete included
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/players?search=alexander&per_page=2
1Parameters
| Name | What it is |
|---|---|
searchrequired | At least 3 letters of a name. |
tour | Men or women: men, women. |
page, per_page | Paging: 50 a page unless you ask, at most 50. See Paging. |
cursor | The meta.next_cursor of the page before, to walk a long list. |
Anything else in the address answers 422 unknown_parameter, with the list of parameters this endpoint takes.
2Request
curl -H "Authorization: Bearer $TDA_KEY" \ "https://api.tennisdatabaseapi.com/v1/players?search=alexander&per_page=2"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/players?search=alexander&per_page=2'); curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('TDA_KEY')], CURLOPT_RETURNTRANSFER => true, ]); $answer = json_decode(curl_exec($ch), true); print_r($answer['data']);
import os, requests r = requests.get( "https://api.tennisdatabaseapi.com/v1/players?search=alexander&per_page=2", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/players?search=alexander&per_page=2", { headers: { Authorization: `Bearer ${process.env.TDA_KEY}` }, }); const { data } = await r.json(); console.log(data);
The code follows the form in Try it, with your key in it once you have entered one. Without a key it reads $TDA_KEY.
3Answer
{
"data": [
{
"id": "pl_b9es70bj",
"name": "Alexander A.",
"full_name": "Alexander Avery",
"country": "Canada",
"tour": "women",
"born": "2009-11-23",
"height_cm": null,
"weight_kg": null,
"plays": "right",
"birthplace": "Greater Sudbury",
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 1073, "highest": 1018, "as_of": "2026-10-31" },
"first_match": "2025-08-10",
"last_match": "2026-10-28"
},
{
"id": "pl_zwcfczsj",
"name": "Alexander B.",
"full_name": "Alexander Borys",
"country": "RSA",
"tour": "men",
"born": null,
"height_cm": null,
"weight_kg": null,
"plays": "right",
"birthplace": null,
"turned_pro": null,
"retired": null,
"college": null,
"ranking": null,
"first_match": "2025-07-13",
"last_match": "2026-07-12"
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"per_page": 2,
"total": 25,
"total_pages": 13,
"next_page": 2,
"prev_page": null
}
}{
"data": [
{
"id": "pl_b9es70bj",
"name": "Alexander A.",
"full_name": "Alexander Avery",
"country": "Canada",
"tour": "women",
"born": "2009-11-23",
"height_cm": null,
"weight_kg": null,
"plays": "right",
"birthplace": "Greater Sudbury",
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 1073, "highest": 1018, "as_of": "2026-10-31" },
"first_match": "2025-08-10",
"last_match": "2026-10-28"
},
{
"id": "pl_zwcfczsj",
"name": "Alexander B.",
"full_name": "Alexander Borys",
"country": "RSA",
"tour": "men",
"born": null,
"height_cm": null,
"weight_kg": null,
"plays": "right",
"birthplace": null,
"turned_pro": null,
"retired": null,
"college": null,
"ranking": null,
"first_match": "2025-07-13",
"last_match": "2026-07-12"
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"per_page": 2,
"total": 25,
"total_pages": 13,
"next_page": 2,
"prev_page": null
}
}{
"error": {
"code": "bad_request",
"message": "search needs at least 3 letters of a name.",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}Real answers from the API, made 2026-11-18. Long lists are cut to three items here.
4Fields
| Field | What it holds |
|---|---|
id | The player id, pl_ and 8 characters |
name, full_name | The name as it appears on a draw, and the full name where known |
country | The country the player represents, by name (such as Spain) |
tour | men or women |
born, height_cm, weight_kg, plays | Date of birth, height, weight and playing hand, where known |
birthplace, turned_pro, retired, college | Where they were born, the years they turned professional and retired, and the college they played for, where known |
ranking | current and highest singles ranking, and as_of, the day it was read |
first_match, last_match | The first and the latest match held |
5Errors
bad_request | A value out of range, such as a date or a tier that is not one of the list. |
unauthorized | No key, or a key that is unknown or revoked. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |