From a8749f5aa5e913f6373b1f11b7d351b034447acd Mon Sep 17 00:00:00 2001 From: Live Tennis API Date: Fri, 6 Nov 2026 12:33:34 +0200 Subject: [PATCH 1/2] Publish the tennis data vocabulary page and JSON Developers joining tennis data keep asking what a tier, round or level code means, and public datasets disagree with each other. The API already has closed vocabularies for all of these, spread across the spec. The generator now writes tennis-data-vocabulary.html and tennis-data-vocabulary.json from openapi.yaml: 22 vocabularies and 164 codes, each with its meaning and its own link. Every code in the spec must have a meaning in VOCABULARIES or the build fails, so a new code cannot ship undocumented. The page is linked from the hub, the topic menu, the sitemap and llms.txt. --- docs/ai-sdk.html | 3 +- docs/auth-quota-and-health.html | 3 +- docs/broadcast-graphics.html | 3 +- docs/changelog.html | 2 +- docs/historical-results-archive.html | 3 +- docs/index.html | 3 +- docs/live-scores.html | 3 +- docs/llms.txt | 1 + docs/players-and-tournaments.html | 3 +- docs/point-by-point-history.html | 3 +- docs/push-feed-and-webhooks.html | 3 +- docs/reference.html | 3 +- docs/shot-level-rally-data.html | 3 +- docs/sitemap.xml | 1 + docs/tennis-data-vocabulary.html | 344 +++++++++ docs/tennis-data-vocabulary.json | 1061 ++++++++++++++++++++++++++ docs/tennis-odds.html | 3 +- scripts/build_reference.py | 478 ++++++++++++ 18 files changed, 1910 insertions(+), 13 deletions(-) create mode 100644 docs/tennis-data-vocabulary.html create mode 100644 docs/tennis-data-vocabulary.json diff --git a/docs/ai-sdk.html b/docs/ai-sdk.html index 741f3d3..61348b0 100644 --- a/docs/ai-sdk.html +++ b/docs/ai-sdk.html @@ -200,7 +200,7 @@ -
Live Tennis API DocsGet a free key
Explore the documentation
+
Live Tennis API DocsGet a free key
Explore the documentation

Live Tennis API · docs · guide

@@ -315,6 +315,7 @@ Tennis scores for on-air graphics Tennis WebSocket feed and webhooks Tennis API authentication, quota and status +Tennis data vocabulary: tiers, rounds, surfaces and results

Written for livetennisapi-ai 1.3.0. Package source in livetennisapi/livetennisapi-ai, page source in livetennisapi/openapi.

Built by Synapse Research Ltd.

diff --git a/docs/auth-quota-and-health.html b/docs/auth-quota-and-health.html index 869de53..2eaa38d 100644 --- a/docs/auth-quota-and-health.html +++ b/docs/auth-quota-and-health.html @@ -199,7 +199,7 @@ -
Live Tennis API DocsGet a free key
Explore the documentation
+
Live Tennis API DocsGet a free key
Explore the documentation

Live Tennis API · docs · version 1.13.78

@@ -252,6 +252,7 @@

Example

curl https://api.livetennisapi.com/api/public/v1/usag
 Tennis scores for on-air graphics
 Tennis WebSocket feed and webhooks
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results
 
 
Generated from openapi.yaml by
 livetennisapi/openapi. Every endpoint on
diff --git a/docs/broadcast-graphics.html b/docs/broadcast-graphics.html
index 24369db..95ba37b 100644
--- a/docs/broadcast-graphics.html
+++ b/docs/broadcast-graphics.html
@@ -199,7 +199,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 

 
Live Tennis API · docs · version 1.13.78

@@ -272,6 +272,7 @@ 
Example
curl https://api.livetennisapi.com/api/public/v1/broa
 Tennis WebSocket feed and webhooks
 Tennis API authentication, quota and status
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results
 
 
Generated from openapi.yaml by
 livetennisapi/openapi. Every endpoint on
diff --git a/docs/changelog.html b/docs/changelog.html
index 1425d1e..f60eabc 100644
--- a/docs/changelog.html
+++ b/docs/changelog.html
@@ -199,7 +199,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 

 
Live Tennis API · docs

diff --git a/docs/historical-results-archive.html b/docs/historical-results-archive.html
index 4042e7b..6dc72a5 100644
--- a/docs/historical-results-archive.html
+++ b/docs/historical-results-archive.html
@@ -199,7 +199,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 

 
Live Tennis API · docs · version 1.13.78

@@ -312,6 +312,7 @@ 
Example
curl https://api.livetennisapi.com/api/public/v1/h2h
 Tennis WebSocket feed and webhooks
 Tennis API authentication, quota and status
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results
 
 
Generated from openapi.yaml by
 livetennisapi/openapi. Every endpoint on
diff --git a/docs/index.html b/docs/index.html
index 6557ea3..c96b90c 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -345,7 +345,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

   
@@ -387,6 +387,7 @@ 
Tennis data.
Start building.

       08 / STREAMINGWebSocket & webhooksConnect to push updates and delivery endpoints.
       09 / ESSENTIALSAuth, quota & statusAuthenticate, understand limits and check health.
       10 / AI SDKVercel AI SDK toolsGive a model live scores and history with livetennisapi-ai.
+      11 / CODESTennis data vocabularyWhat every tier, round, surface and result code means.
     
     
     
Official clientspip install livetennisapinpm install livetennisapinpx livetennisapi-mcpnpm install livetennisapi-ai

diff --git a/docs/live-scores.html b/docs/live-scores.html
index 75d2c09..c709797 100644
--- a/docs/live-scores.html
+++ b/docs/live-scores.html
@@ -199,7 +199,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 

 
Live Tennis API · docs · version 1.13.78

@@ -438,6 +438,7 @@ 
Example
curl https://api.livetennisapi.com/api/public/v1/fixt
 Tennis WebSocket feed and webhooks
 Tennis API authentication, quota and status
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results
 
 
Generated from openapi.yaml by
 livetennisapi/openapi. Every endpoint on
diff --git a/docs/llms.txt b/docs/llms.txt
index 93942c3..bbb1792 100644
--- a/docs/llms.txt
+++ b/docs/llms.txt
@@ -29,6 +29,7 @@ endpoints, generated from the same spec as the reference:
 
 ## Guides
 - How do you give a Vercel AI SDK model live tennis data? https://docs.livetennisapi.com/ai-sdk.html
+- What does each tennis data code mean? https://docs.livetennisapi.com/tennis-data-vocabulary.html
 
 ## Quickstart (no code required)
 Open this in a browser — no install, no headers: https://api.livetennisapi.com/api/public/v1/matches?status=live&token=YOUR_KEY
diff --git a/docs/players-and-tournaments.html b/docs/players-and-tournaments.html
index 26e799e..ce42159 100644
--- a/docs/players-and-tournaments.html
+++ b/docs/players-and-tournaments.html
@@ -199,7 +199,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 

 
Live Tennis API · docs · version 1.13.78

@@ -329,6 +329,7 @@ 
Example
curl https://api.livetennisapi.com/api/public/v1/rank
 Tennis WebSocket feed and webhooks
 Tennis API authentication, quota and status
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results
 
 
Generated from openapi.yaml by
 livetennisapi/openapi. Every endpoint on
diff --git a/docs/point-by-point-history.html b/docs/point-by-point-history.html
index c18eff9..340eec1 100644
--- a/docs/point-by-point-history.html
+++ b/docs/point-by-point-history.html
@@ -199,7 +199,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 

 
Live Tennis API · docs · version 1.13.78

@@ -333,6 +333,7 @@ 
Example
curl https://api.livetennisapi.com/api/public/v1/hist
 Tennis WebSocket feed and webhooks
 Tennis API authentication, quota and status
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results
 
 
Generated from openapi.yaml by
 livetennisapi/openapi. Every endpoint on
diff --git a/docs/push-feed-and-webhooks.html b/docs/push-feed-and-webhooks.html
index e53df41..f635441 100644
--- a/docs/push-feed-and-webhooks.html
+++ b/docs/push-feed-and-webhooks.html
@@ -199,7 +199,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 

 
Live Tennis API · docs · version 1.13.78

@@ -292,6 +292,7 @@ 
Example
curl https://api.livetennisapi.com/api/public/v1/ws-t
 Tennis scores for on-air graphics
 Tennis API authentication, quota and status
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results
 
 
Generated from openapi.yaml by
 livetennisapi/openapi. Every endpoint on
diff --git a/docs/reference.html b/docs/reference.html
index e6b25f1..942a19b 100644
--- a/docs/reference.html
+++ b/docs/reference.html
@@ -202,7 +202,7 @@
 
 
 
-
Live Tennis API DocsGet a free key 
Explore the documentation

+
Live Tennis API DocsGet a free key 
Explore the documentation

 

 
 

@@ -227,6 +227,7 @@ 
Live Tennis API — Full Reference

 Tennis WebSocket feed and webhooks
 Tennis API authentication, quota and status
 Live Tennis API tools for the Vercel AI SDK
+Tennis data vocabulary: tiers, rounds, surfaces and results