tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsAccount and dataCoverage
Account and data

Coverage

GEThttps://api.tennisdatabaseapi.com/v1/meta/coverageEvery plan

What the database holds, season by season, counted from the data.

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/meta/coverage

1Parameters

None. Anything in the address answers 422 unknown_parameter.

2Request

curl -H "Authorization: Bearer $TDA_KEY" \
  "https://api.tennisdatabaseapi.com/v1/meta/coverage"

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": {
    "seasons": {
      "2026": {
        "men": { "matches": 64437, "with_odds": 44905, "with_markets": 29625, "with_stats": 28411 },
        "women": { "matches": 46101, "with_odds": 34018, "with_markets": 20496, "with_stats": 22941 }
      },
      "2025": {
        "men": { "matches": 70676, "with_odds": 46955, "with_markets": 30081, "with_stats": 29386 },
        "women": { "matches": 52961, "with_odds": 36303, "with_markets": 21919, "with_stats": 25194 }
      },
      "2024": {
        "men": { "matches": 59948, "with_odds": 39966, "with_markets": 30481, "with_stats": 21617 },
        "women": { "matches": 45209, "with_odds": 32775, "with_markets": 22796, "with_stats": 16807 }
      },
      "...": "..."
    },
    "totals": {
      "matches": 2344851,
      "players": 103674,
      "tournaments": 16440,
      "with_odds": 939079,
      "with_markets": 461173,
      "with_stats": 291719,
      "price_moves": 61320228,
      "first_day": "1877-07-09",
      "last_day": "2026-11-18"
    }
  },
  "meta": { "counted_at": "2026-11-18 04:23:48" }
}

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

4Fields

FieldTypeWhat it holds
seasonsobjectEach season, for men and women: matches, with_odds, with_markets, with_stats
totalsobjectMatches, players, tournaments, priced matches, markets, statistics and price moves, with the first and last day

5Errors

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).