Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,11 @@ All notable changes to the specification are recorded here.
The API surface is versioned as `v1`. Changes within `v1` are **additive only**;
removing a field or changing its type would require `v2`.

## [1.13.83] - 2026-11-12

### Added
- **A client libraries page.** `client-libraries.html` lists the eight official language clients and seven packages built on them. Each row has the install command, the latest published version, the minimum runtime, the licence and the source repository. A second table says whether each package covers REST, the live stream, file export and MCP. A third shows which endpoint groups each language client reaches, read from the source of each published version. The page ends with the smallest working call in each language, copied from that library's README. `scripts/check_client_versions.py` reads the registries again and names any row that is behind. The build fails when the page names an operation the spec does not define. The docs menu, the docs home, the sitemap, llms.txt and the README link the page. Nothing on the wire changed.

## [1.13.82] - 2026-11-12

### Fixed
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,8 @@ Everything in the Live Tennis API developer surface:
| Vercel AI SDK tools | `npm install livetennisapi-ai` ([guide](https://docs.livetennisapi.com/ai-sdk.html)) | [repo](https://github.com/livetennisapi/livetennisapi-ai) | [package](https://www.npmjs.com/package/livetennisapi-ai) |
| CSV, JSON Lines and Parquet export | `pip install livetennisapi-export` ([guide](https://docs.livetennisapi.com/export-formats.html)) | [repo](https://github.com/livetennisapi/livetennisapi-export) | [package](https://pypi.org/project/livetennisapi-export/) |

The [client libraries page](https://docs.livetennisapi.com/client-libraries.html) lists every client library with its latest version and minimum runtime. It also shows which endpoints each language client covers.

- **API reference** — <https://docs.livetennisapi.com> ([plain-HTML version](https://docs.livetennisapi.com/reference.html), no JavaScript required)
- **Website and plans** — <https://livetennisapi.com>
- **Get a free key** — <https://livetennisapi.com/subscribe/free>
Expand Down
3 changes: 2 additions & 1 deletion docs/ai-sdk.html
Original file line number Diff line number Diff line change
Expand Up @@ -200,7 +200,7 @@
</head>
<body class="docs-page docs-topic">
<a class="skip-link" href="#main">Skip to content</a>
<header class="docs-site-header"><a class="docs-brand" href="./"><img src="logo.svg" width="28" height="28" alt="">Live Tennis API <span>Docs</span></a><nav class="docs-desktop-nav" aria-label="Documentation"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a></nav><a class="docs-key" href="https://livetennisapi.com/subscribe/free">Get a free key <span aria-hidden="true">↗</span></a></header><details class="docs-topic-menu"><summary>Explore the documentation</summary><nav aria-label="Documentation topics"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a><a href="./live-scores.html">Live tennis scores API</a><a href="./players-and-tournaments.html">Tennis players, tournaments and rankings API</a><a href="./tennis-odds.html">Tennis odds API — markets and price ticks</a><a href="./point-by-point-history.html">Point-by-point tennis data API</a><a href="./historical-results-archive.html">Historical tennis results API — 1968 onward</a><a href="./shot-level-rally-data.html">Shot-by-shot tennis rally and charting API</a><a href="./broadcast-graphics.html">Tennis scores for on-air graphics</a><a href="./push-feed-and-webhooks.html">Tennis WebSocket feed and webhooks</a><a href="./auth-quota-and-health.html">Tennis API authentication, quota and status</a><a href="./ai-sdk.html" aria-current="page">Live Tennis API tools for the Vercel AI SDK</a><a href="./errors-and-rate-limits.html">Errors and rate limits</a><a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a></nav></details>
<header class="docs-site-header"><a class="docs-brand" href="./"><img src="logo.svg" width="28" height="28" alt="">Live Tennis API <span>Docs</span></a><nav class="docs-desktop-nav" aria-label="Documentation"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a></nav><a class="docs-key" href="https://livetennisapi.com/subscribe/free">Get a free key <span aria-hidden="true">↗</span></a></header><details class="docs-topic-menu"><summary>Explore the documentation</summary><nav aria-label="Documentation topics"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a><a href="./live-scores.html">Live tennis scores API</a><a href="./players-and-tournaments.html">Tennis players, tournaments and rankings API</a><a href="./tennis-odds.html">Tennis odds API — markets and price ticks</a><a href="./point-by-point-history.html">Point-by-point tennis data API</a><a href="./historical-results-archive.html">Historical tennis results API — 1968 onward</a><a href="./shot-level-rally-data.html">Shot-by-shot tennis rally and charting API</a><a href="./broadcast-graphics.html">Tennis scores for on-air graphics</a><a href="./push-feed-and-webhooks.html">Tennis WebSocket feed and webhooks</a><a href="./auth-quota-and-health.html">Tennis API authentication, quota and status</a><a href="./ai-sdk.html" aria-current="page">Live Tennis API tools for the Vercel AI SDK</a><a href="./errors-and-rate-limits.html">Errors and rate limits</a><a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a><a href="./client-libraries.html">Live Tennis API client libraries</a></nav></details>
<div class="wrap">
<header role="none">
<p class="meta">Live Tennis API &middot; docs &middot; guide</p>
Expand Down Expand Up @@ -317,6 +317,7 @@ <h2 id="links">Links</h2>
<a href="./auth-quota-and-health.html">Tennis API authentication, quota and status</a>
<a href="./errors-and-rate-limits.html">Errors and rate limits</a>
<a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a>
<a href="./client-libraries.html">Live Tennis API client libraries</a>
</nav>
<p class="meta">Written for <a href="https://www.npmjs.com/package/livetennisapi-ai">livetennisapi-ai</a> 1.3.0. Package source in <a href="https://github.com/livetennisapi/livetennisapi-ai">livetennisapi/livetennisapi-ai</a>, page source in <a href="https://github.com/livetennisapi/openapi">livetennisapi/openapi</a>.</p>
<p class="meta">Built by <a href="https://synapsereality.io/work/live-tennis-api/">Synapse Research Ltd</a>.</p>
Expand Down
5 changes: 3 additions & 2 deletions docs/auth-quota-and-health.html
Original file line number Diff line number Diff line change
Expand Up @@ -199,10 +199,10 @@
</head>
<body class="docs-page docs-topic">
<a class="skip-link" href="#main">Skip to content</a>
<header class="docs-site-header"><a class="docs-brand" href="./"><img src="logo.svg" width="28" height="28" alt="">Live Tennis API <span>Docs</span></a><nav class="docs-desktop-nav" aria-label="Documentation"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a></nav><a class="docs-key" href="https://livetennisapi.com/subscribe/free">Get a free key <span aria-hidden="true">↗</span></a></header><details class="docs-topic-menu"><summary>Explore the documentation</summary><nav aria-label="Documentation topics"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a><a href="./live-scores.html">Live tennis scores API</a><a href="./players-and-tournaments.html">Tennis players, tournaments and rankings API</a><a href="./tennis-odds.html">Tennis odds API — markets and price ticks</a><a href="./point-by-point-history.html">Point-by-point tennis data API</a><a href="./historical-results-archive.html">Historical tennis results API — 1968 onward</a><a href="./shot-level-rally-data.html">Shot-by-shot tennis rally and charting API</a><a href="./broadcast-graphics.html">Tennis scores for on-air graphics</a><a href="./push-feed-and-webhooks.html">Tennis WebSocket feed and webhooks</a><a href="./auth-quota-and-health.html" aria-current="page">Tennis API authentication, quota and status</a><a href="./ai-sdk.html">Live Tennis API tools for the Vercel AI SDK</a><a href="./errors-and-rate-limits.html">Errors and rate limits</a><a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a></nav></details>
<header class="docs-site-header"><a class="docs-brand" href="./"><img src="logo.svg" width="28" height="28" alt="">Live Tennis API <span>Docs</span></a><nav class="docs-desktop-nav" aria-label="Documentation"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a></nav><a class="docs-key" href="https://livetennisapi.com/subscribe/free">Get a free key <span aria-hidden="true">↗</span></a></header><details class="docs-topic-menu"><summary>Explore the documentation</summary><nav aria-label="Documentation topics"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a><a href="./live-scores.html">Live tennis scores API</a><a href="./players-and-tournaments.html">Tennis players, tournaments and rankings API</a><a href="./tennis-odds.html">Tennis odds API — markets and price ticks</a><a href="./point-by-point-history.html">Point-by-point tennis data API</a><a href="./historical-results-archive.html">Historical tennis results API — 1968 onward</a><a href="./shot-level-rally-data.html">Shot-by-shot tennis rally and charting API</a><a href="./broadcast-graphics.html">Tennis scores for on-air graphics</a><a href="./push-feed-and-webhooks.html">Tennis WebSocket feed and webhooks</a><a href="./auth-quota-and-health.html" aria-current="page">Tennis API authentication, quota and status</a><a href="./ai-sdk.html">Live Tennis API tools for the Vercel AI SDK</a><a href="./errors-and-rate-limits.html">Errors and rate limits</a><a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a><a href="./client-libraries.html">Live Tennis API client libraries</a></nav></details>
<div class="wrap">
<header>
<p class="meta">Live Tennis API &middot; docs &middot; version 1.13.82</p>
<p class="meta">Live Tennis API &middot; docs &middot; version 1.13.83</p>
<h1>Tennis API authentication, quota and status</h1>
<p><strong>How do you authenticate, and how do you see what quota is left?</strong> Send your key as <code>X-API-Key</code> on every request. <code>GET /usage</code> returns your own consumption against your plan's quota and works on every tier including FREE, so a client can check its own headroom before a burst. <code>GET /health</code> is the unauthenticated liveness probe.</p>
<p class="meta">2 endpoints on this page. Base URL
Expand Down Expand Up @@ -254,6 +254,7 @@ <h4>Example</h4><pre><code>curl https://api.livetennisapi.com/api/public/v1/usag
<a href="./ai-sdk.html">Live Tennis API tools for the Vercel AI SDK</a>
<a href="./errors-and-rate-limits.html">Errors and rate limits</a>
<a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a>
<a href="./client-libraries.html">Live Tennis API client libraries</a>
</nav>
<p class="meta">Generated from <a href="./openapi.yaml">openapi.yaml</a> by
<a href="https://github.com/livetennisapi/openapi">livetennisapi/openapi</a>. Every endpoint on
Expand Down
5 changes: 3 additions & 2 deletions docs/broadcast-graphics.html
Original file line number Diff line number Diff line change
Expand Up @@ -199,10 +199,10 @@
</head>
<body class="docs-page docs-topic">
<a class="skip-link" href="#main">Skip to content</a>
<header class="docs-site-header"><a class="docs-brand" href="./"><img src="logo.svg" width="28" height="28" alt="">Live Tennis API <span>Docs</span></a><nav class="docs-desktop-nav" aria-label="Documentation"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a></nav><a class="docs-key" href="https://livetennisapi.com/subscribe/free">Get a free key <span aria-hidden="true">↗</span></a></header><details class="docs-topic-menu"><summary>Explore the documentation</summary><nav aria-label="Documentation topics"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a><a href="./live-scores.html">Live tennis scores API</a><a href="./players-and-tournaments.html">Tennis players, tournaments and rankings API</a><a href="./tennis-odds.html">Tennis odds API — markets and price ticks</a><a href="./point-by-point-history.html">Point-by-point tennis data API</a><a href="./historical-results-archive.html">Historical tennis results API — 1968 onward</a><a href="./shot-level-rally-data.html">Shot-by-shot tennis rally and charting API</a><a href="./broadcast-graphics.html" aria-current="page">Tennis scores for on-air graphics</a><a href="./push-feed-and-webhooks.html">Tennis WebSocket feed and webhooks</a><a href="./auth-quota-and-health.html">Tennis API authentication, quota and status</a><a href="./ai-sdk.html">Live Tennis API tools for the Vercel AI SDK</a><a href="./errors-and-rate-limits.html">Errors and rate limits</a><a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a></nav></details>
<header class="docs-site-header"><a class="docs-brand" href="./"><img src="logo.svg" width="28" height="28" alt="">Live Tennis API <span>Docs</span></a><nav class="docs-desktop-nav" aria-label="Documentation"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a></nav><a class="docs-key" href="https://livetennisapi.com/subscribe/free">Get a free key <span aria-hidden="true">↗</span></a></header><details class="docs-topic-menu"><summary>Explore the documentation</summary><nav aria-label="Documentation topics"><a href="./">Overview</a><a href="./reference.html">API reference</a><a href="./changelog.html">Changelog</a><a href="./live-scores.html">Live tennis scores API</a><a href="./players-and-tournaments.html">Tennis players, tournaments and rankings API</a><a href="./tennis-odds.html">Tennis odds API — markets and price ticks</a><a href="./point-by-point-history.html">Point-by-point tennis data API</a><a href="./historical-results-archive.html">Historical tennis results API — 1968 onward</a><a href="./shot-level-rally-data.html">Shot-by-shot tennis rally and charting API</a><a href="./broadcast-graphics.html" aria-current="page">Tennis scores for on-air graphics</a><a href="./push-feed-and-webhooks.html">Tennis WebSocket feed and webhooks</a><a href="./auth-quota-and-health.html">Tennis API authentication, quota and status</a><a href="./ai-sdk.html">Live Tennis API tools for the Vercel AI SDK</a><a href="./errors-and-rate-limits.html">Errors and rate limits</a><a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a><a href="./client-libraries.html">Live Tennis API client libraries</a></nav></details>
<div class="wrap">
<header>
<p class="meta">Live Tennis API &middot; docs &middot; version 1.13.82</p>
<p class="meta">Live Tennis API &middot; docs &middot; version 1.13.83</p>
<h1>Tennis scores for on-air graphics</h1>
<p><strong>How do you put live tennis scores into a broadcast graphics template?</strong> <code>GET /broadcast/match/{matchId}</code> returns ONE flat object for one match and <code>GET /broadcast/live</code> the same object for every live match in a single call. Both are ULTRA. A graphics template binds each field to a fixed path, so three things are contractual: the object is flat, every key is present on every read (<code>null</code>, never missing), and the score is already in display form — <code>p1_points</code> reads <code>"40"</code> or <code>"AD"</code> and <code>set_line</code> is one string. Built for 1 Hz: every response carries a strong <code>ETag</code>, so <code>If-None-Match</code> makes an unchanged state a 304 with no body. Detect a new state on <code>sequence</code>, never on <code>served_at</code>, which changes on every read.</p>
<p class="meta">2 endpoints on this page. Base URL
Expand Down Expand Up @@ -274,6 +274,7 @@ <h4>Example</h4><pre><code>curl https://api.livetennisapi.com/api/public/v1/broa
<a href="./ai-sdk.html">Live Tennis API tools for the Vercel AI SDK</a>
<a href="./errors-and-rate-limits.html">Errors and rate limits</a>
<a href="./export-formats.html">Export tennis data to CSV, JSON Lines or Parquet</a>
<a href="./client-libraries.html">Live Tennis API client libraries</a>
</nav>
<p class="meta">Generated from <a href="./openapi.yaml">openapi.yaml</a> by
<a href="https://github.com/livetennisapi/openapi">livetennisapi/openapi</a>. Every endpoint on
Expand Down
Loading
Loading