tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsPlayersFind players
Players

Find players

MCP tool find_player
GEThttps://api.tennisdatabaseapi.com/v1/playersEvery plan

Find 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

NameInTypeWhat it is
searchrequiredquerystringAt least 3 letters of a name.
tourquerystringMen or women: men, women.
page, per_pagequeryintegerPaging: 50 a page unless you ask, at most 50. See Paging.
cursorquerystringThe 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"

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
  }
}

Real answers from the API, made 2026-11-18. Long lists are cut to three items here.

4Fields

FieldTypeWhat it holds
idstringThe player id, pl_ and 8 characters
name, full_namestringThe name as it appears on a draw, and the full name where known
countrystringThe country the player represents, by name (such as Spain)
tourstringmen or women
born, height_cm, weight_kg, playsmixedDate of birth, height, weight and playing hand, where known
birthplace, turned_pro, retired, collegemixedWhere they were born, the years they turned professional and retired, and the college they played for, where known
rankingobjectcurrent and highest singles ranking, and as_of, the day it was read
first_match, last_matchdateThe first and the latest match held

5Errors

400bad_requestA value out of range, such as a date or a tier that is not one of the list.
401unauthorizedNo key, or a key that is unknown or revoked.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).