GET
https://api.tennisdatabaseapi.com/v1/searchEvery planPlayers and tournaments together, 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/search?q=alexander
1Parameters
| Name | What it is |
|---|---|
qrequired | At least 2 letters of a name. |
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/search?q=alexander"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/search?q=alexander'); 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/search?q=alexander", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/search?q=alexander", { 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": {
"players": [
{
"id": "pl_f560sfd7",
"name": "Zverev A.",
"full_name": "Zverev Alexander",
"country": "Germany",
"tour": "men",
"born": "1997-04-20",
"height_cm": 198,
"weight_kg": 90,
"plays": "right",
"birthplace": null,
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 2, "highest": 2, "as_of": "2026-10-31" },
"first_match": "2011-08-05",
"last_match": "2026-11-17"
},
{
"id": "pl_e4j6kk1a",
"name": "Bublik A.",
"full_name": "Bublik Alexander",
"country": "Kazakhstan",
"tour": "men",
"born": "1997-06-17",
"height_cm": 198,
"weight_kg": 77,
"plays": "right",
"birthplace": "Gatchina",
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 20, "highest": 10, "as_of": "2026-10-31" },
"first_match": "2011-08-30",
"last_match": "2026-10-25"
},
{
"id": "pl_hxa2p8f7",
"name": "Blockx A.",
"full_name": "Blockx Alexander",
"country": "Belgium",
"tour": "men",
"born": "2005-04-08",
"height_cm": 193,
"weight_kg": 83,
"plays": "right",
"birthplace": "Antwerp",
"turned_pro": 2021,
"retired": null,
"college": null,
"ranking": { "current": 27, "highest": 27, "as_of": "2026-11-01" },
"first_match": "2021-08-22",
"last_match": "2026-10-10"
},
"..."
],
"tournaments": []
},
"meta": { "players": 10, "tournaments": 0 }
}{
"data": {
"players": [
{
"id": "pl_f560sfd7",
"name": "Zverev A.",
"full_name": "Zverev Alexander",
"country": "Germany",
"tour": "men",
"born": "1997-04-20",
"height_cm": 198,
"weight_kg": 90,
"plays": "right",
"birthplace": null,
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 2, "highest": 2, "as_of": "2026-10-31" },
"first_match": "2011-08-05",
"last_match": "2026-11-17"
},
{
"id": "pl_e4j6kk1a",
"name": "Bublik A.",
"full_name": "Bublik Alexander",
"country": "Kazakhstan",
"tour": "men",
"born": "1997-06-17",
"height_cm": 198,
"weight_kg": 77,
"plays": "right",
"birthplace": "Gatchina",
"turned_pro": null,
"retired": null,
"college": null,
"ranking": { "current": 20, "highest": 10, "as_of": "2026-10-31" },
"first_match": "2011-08-30",
"last_match": "2026-10-25"
},
{
"id": "pl_hxa2p8f7",
"name": "Blockx A.",
"full_name": "Blockx Alexander",
"country": "Belgium",
"tour": "men",
"born": "2005-04-08",
"height_cm": 193,
"weight_kg": 83,
"plays": "right",
"birthplace": "Antwerp",
"turned_pro": 2021,
"retired": null,
"college": null,
"ranking": { "current": 27, "highest": 27, "as_of": "2026-11-01" },
"first_match": "2021-08-22",
"last_match": "2026-10-10"
},
"..."
],
"tournaments": []
},
"meta": { "players": 10, "tournaments": 0 }
}{
"error": {
"code": "bad_request",
"message": "q needs at least 2 letters.",
"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 |
|---|---|
players | Up to 10 players, ranked players first, each as in Find players |
tournaments | Up to 10 events, as in Find tournaments |
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). |