GET
https://api.tennisdatabaseapi.com/v1/players/{id}/statisticsPaid plansA player's serve and return figures over every match held with statistics, and their opponents' against them.
Free key not 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/pl_f560sfd7/statistics?season=2026
1Parameters
| Name | What it is |
|---|---|
idrequired | An id from another answer, such as pl_ and 8 characters. Ids are our own and never change. |
season | One season, such as 2024. |
surface | One surface (hard takes indoor hard in): hard, clay, grass, carpet. |
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/pl_f560sfd7/statistics?season=2026"
$ch = curl_init('https://api.tennisdatabaseapi.com/v1/players/pl_f560sfd7/statistics?season=2026'); 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/pl_f560sfd7/statistics?season=2026", headers={"Authorization": f"Bearer {os.environ['TDA_KEY']}"}, ) print(r.json()["data"])
const r = await fetch("https://api.tennisdatabaseapi.com/v1/players/pl_f560sfd7/statistics?season=2026", { 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": {
"player": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
"season": 2026,
"surface": null,
"matches": 85,
"stats": {
"aces": {
"player": { "per_match": 10.25, "total": 871 },
"opponents": { "per_match": 6.76, "total": 575 }
},
"break_points_saved": {
"player": { "won": 191, "of": 302, "pct": 63.2 },
"opponents": { "won": 378, "of": 632, "pct": 59.8 }
},
"break_points_won": {
"player": { "won": 254, "of": 632, "pct": 40.2 },
"opponents": { "won": 111, "of": 302, "pct": 36.8 }
},
"double_faults": {
"player": { "per_match": 2.28, "total": 194 },
"opponents": { "per_match": 2.73, "total": 232 }
},
"first_return_points_won": {
"player": { "won": 1389, "of": 4853, "pct": 28.6 },
"opponents": { "won": 1125, "of": 4935, "pct": 22.8 }
},
"first_serve_points_won": {
"player": { "won": 3816, "of": 4935, "pct": 77.3 },
"opponents": { "won": 3465, "of": 4853, "pct": 71.4 }
},
"first_serve_speed_kmh": {
"player": { "per_match": 205.5, "total": 5343 },
"opponents": { "per_match": 192.31, "total": 5000 }
},
"last_10_points": {
"player": { "per_match": 5.93, "total": 504 },
"opponents": { "per_match": 4.07, "total": 346 }
},
"match_points_saved": {
"player": { "per_match": 0.14, "total": 12 },
"opponents": { "per_match": 0.62, "total": 53 }
},
"net_points_won": {
"player": { "won": 932, "of": 1317, "pct": 70.8 },
"opponents": { "won": 843, "of": 1197, "pct": 70.4 }
},
"return_games_won": {
"player": { "won": 254, "of": 1164, "pct": 21.8 },
"opponents": { "won": 111, "of": 1168, "pct": 9.5 }
},
"return_points_won": {
"player": { "won": 2792, "of": 7584, "pct": 36.8 },
"opponents": { "won": 1953, "of": 6884, "pct": 28.4 }
},
"second_return_points_won": {
"player": { "won": 1400, "of": 2721, "pct": 51.5 },
"opponents": { "won": 834, "of": 1947, "pct": 42.8 }
},
"second_serve_points_won": {
"player": { "won": 1114, "of": 1947, "pct": 57.2 },
"opponents": { "won": 1321, "of": 2721, "pct": 48.5 }
},
"second_serve_speed_kmh": {
"player": { "per_match": 177.19, "total": 4607 },
"opponents": { "per_match": 157.54, "total": 4096 }
},
"service_games_won": {
"player": { "won": 1057, "of": 1168, "pct": 90.5 },
"opponents": { "won": 910, "of": 1164, "pct": 78.2 }
},
"service_points_won": {
"player": { "won": 4931, "of": 6884, "pct": 71.6 },
"opponents": { "won": 4792, "of": 7584, "pct": 63.2 }
},
"total_games_won": {
"player": { "won": 1311, "of": 2332, "pct": 56.2 },
"opponents": { "won": 1021, "of": 2332, "pct": 43.8 }
},
"total_points_won": {
"player": { "won": 7723, "of": 14468, "pct": 53.4 },
"opponents": { "won": 6745, "of": 14468, "pct": 46.6 }
},
"unforced_errors": {
"player": { "per_match": 26.23, "total": 1836 },
"opponents": { "per_match": 29.24, "total": 2047 }
},
"winners": {
"player": { "per_match": 32.23, "total": 2256 },
"opponents": { "per_match": 27, "total": 1890 }
}
}
},
"meta": {}
}{
"error": {
"code": "upgrade_required",
"message": "This endpoint is on the Live plan and above.",
"plan": "Live",
"upgrade": "https://tennisdatabaseapi.com/pricing",
"docs": "https://tennisdatabaseapi.com/documentation/errors"
}
}{
"error": {
"code": "bad_request",
"message": "season is a year, such as 2024.",
"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 |
|---|---|
player, season, surface | Who, and the season and surface asked for |
matches | How many matches held with statistics are counted |
stats | Each figure for the player and their opponents: a share as won, of and pct, a count as per_match and total |
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. |
upgrade_required | The free key: this endpoint is on the Live plan and above. |
not_found | No such id. |
unknown_parameter | A parameter this endpoint does not take. |
rate_limited | Too many calls this minute, or the allowance used (quota_exceeded). |