Live Tennis API

Real-time tennis data over REST and WebSocket. Live scores, players, rankings, head-to-heads, a 1968–2022 results archive, match-winner market prices and model win-probability — for ATP, WTA, Challenger, ITF and juniors.

Get a free API key — no card · Documentation · Website · Pricing

fromlivetennisapiimportLiveTennisAPIwithLiveTennisAPI() asclient: # reads LIVETENNISAPI_KEYformatchinclient.list_matches(status="live"):
print(match.tournament, match.score.sets)

import{LiveTennisAPI}from'livetennisapi';const{ data }=awaitnewLiveTennisAPI().listMatches({status: 'live'});

Both ship a livetennis CLI and a reconnecting WebSocket client. The MCP server gives Claude, Cursor and other LLM agents 24 read-only tools over the same data.

Every response is JSON. Authenticate with Authorization: Bearer (preferred) or an X-API-Key header — either works. A free key ($0, no card) covers everything below:

curl https://api.livetennisapi.com/api/public/v1/matches?status=live \
-H "Authorization: Bearer $LIVETENNISAPI_KEY"

{
"data": [
{
"id": 18953,
"tournament": "ATP Wimbledon",
"surface": "grass",
"round": "R16",
"status": "live",
"players": { "p1": { "name": "…", "ranking": 3 }, "p2": { "name": "…" } },
"score": { "sets": [1, 1], "games": [[6, 3, 2], [4, 6, 1]], "points": ["40", "30"], "server": 1 }
}
],
"meta": { "limit": 50, "offset": 0, "count": 1, "total": 1, "has_more": false }
}

No key yet? Grab a free one — or hit the liveness probe, which needs no auth:

curl https://api.livetennisapi.com/api/public/v1/health
# {"status":"ok","version":"v1"}

¹ Bulk paging of completed matches (GET /matches?status=completed) needs the BASIC tier or any History plan; a single completed match by id (GET /matches/{id}) is FREE. ² Or any History plan — History plans work on top of a free core key. ³ Or History Pro and above.

¹ Also unlocked by any History plan, on top of a free core key.

Start free — a FREE key is fine to use from browser code (CORS is open, GET-only, no credentials mode); keep paid keys server-side.

Calling above your tier returns 403 {"error":"upgrade_required"} — never a silent empty result. Upgrade any time at livetennisapi.com/subscribe/upgrade.

• Base URL — https://api.livetennisapi.com/api/public/v1
• Timestamps — UTC ISO 8601 with a Z suffix, everywhere.
• Lists return {data, meta}; single resources return the object directly.
• Pagination — limit (default 50, max 200) and offset; page while meta.has_more is true (meta.total may be null).
• Score shape — sets is [sets_p1, sets_p2]; games is [games_p1, games_p2] where each side is a per-set list, so [[6,3,2],[4,6,1]] reads 6-4, 3-6, 2-1.
• Forward compatibility — ignore unknown fields. Additive changes land within v1, so clients should not reject responses carrying fields they don't recognise.
• Errors — 401 unauthorized · 403 upgrade_required · 404 · 429 (honour Retry-After; the body's resets_at and the X-RateLimit-Reset header give the exact UTC instant your quota resets).

• docs.livetennisapi.com — interactive API reference
• Plain-HTML reference — the same content with no JavaScript, readable by any client or crawler
• OpenAPI 3.1 specification — generate a client in any language
• llms.txt — a machine-readable summary for answer engines

Direct is cheapest, has the only free tier, and issues a key instantly. The API is also listed on the marketplaces you may already be billing through:

Direct — free tier · Direct — paid plans · RapidAPI · Apify · API.market · Postman

The API is live and serving. Anything published in this organisation is tested against the production endpoint before release — see each repository's contract tests.

Know developers who need tennis data? The affiliate program pays 51% recurring commission for the life of every referred subscription — 30-day cookie, and the people you refer get 10% off. Free to join.