TennisDatum

Tennis API / API docs

Tennis API Documentation

Inspect the synthetic API sample and explore the published match snapshot.

Public data preview

Browse the published match snapshot and player result histories. Records show their import time and point coverage. The API sample is synthetic and available without an account.

GET https://tennisdatum.com/sample/match.json

The separate authenticated test API is deployed at https://api.tennisdatum.com. Public website pages use a dated completed-match snapshot. The API preserves observation freshness; source coverage varies. Subscriptions use Stripe-hosted payment links with manual API activation. Automated account provisioning, WebSocket and SSE are not currently offered.

Authenticated API quickstart

Use your privately issued test key on your server. Do not embed it in a public website or put it in a URL.

curl 'https://api.tennisdatum.com/v1/tennis/matches?limit=5' \
  -H 'Authorization: Bearer YOUR_PRIVATE_TEST_KEY'

List results include public match IDs, competitors, score, status, observation time, freshness expiry and history/statistics availability. IDs are provider-scoped and may overlap; record counts are not globally distinct matches.

EndpointResponse
GET /v1/tennis/matchesPaginated match summaries; limit 1–100, offset, optional tour and status.
GET /v1/tennis/matches/{id}Recorded match, score, available partial history and statistics.
GET /v1/tennis/matches/{id}/pointsPartial game/point-score history, or null when unavailable.
GET /v1/tennis/matches/{id}/statisticsAvailable period/side statistics, or null.
GET /v1/tennis/coverageStored record counts by tour and identity/coverage limits.

Live observations expire at response time. An expired live record becomes stale; it is excluded from status=live queries. Finished records use status=finished. Missing statistics remain unavailable.

The initial private test key has a shared 5,000-request daily UTC quota. Rate-limit headers show remaining requests. Errors: 400 invalid query, 401 missing/invalid key, 404 missing record, 405 unsupported method, 429 quota exhausted, 503 service unavailable. This is a test credential, not commercial subscriber provisioning.

Download OpenAPI specification · API configuration and publication health

Data methodology and coverage

TennisDatum presents approved match records with their published labels, surface, score, point coverage and import timestamp. Complete and partial refer to point-sequence coverage. Missing statistics mean unknown.

The website preview does not establish worldwide completeness or a live update SLA. Result pages currently include a bounded sample of completed matches. The separate customer API preserves observation time and freshness expiry. Counts use provider-scoped identities and may overlap.

Review coverage by tour. Report data changes and corrections through Contact.

Build with Python

Follow the Python tennis data API guide to retrieve match results, handle pagination and prepare records for analysis.