Table Tennis V2 API Overview

​

Base URL

https://api.sportsapipro.com/v2/table-tennis

​

Authentication

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/table-tennis/live

​

Table Tennis-Specific Notes

• Best of 5 or 7 games — each game to 11 points (deuce at 10-10, must win by 2)
• Score fields — period1 through period7 represent individual game scores
• Point-by-point — available for live matches via /match/:id/point-by-point
• No current-server indicator — score.serving is returned as -1 for table tennis and there is no firstToServe field; only aggregate service stats are available via /match/:id/statistics
• No match clock — startTimestamp is the scheduled start; derive elapsed time from the first status.type: "inprogress" transition you observe
• Live updates — subscribe to match:{matchId} on the V2 WebSocket for per-point score pushes (measured 140–760 ms)
• Events — MS/WS (singles), MD/WD (doubles), XD (mixed doubles)
• Player traits — playing hand (R/L), grip style (shakehand/penhold)
• High volume — 2,283+ matches per day — use pagination and filters
• 9 categories globally

​

Test IDs

​

Endpoint Summary

​

Example Requests

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/table-tennis/live

const response = await fetch(
  'https://api.sportsapipro.com/v2/table-tennis/live',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v2/table-tennis/live',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

​

UI Design Ideas

• Score display: Show game-by-game scores (e.g., 3-1 with 11-8, 7-11, 11-5, 11-9)
• Match format: Best of 5 games (most events), best of 7 (World Championships finals)
• Games to 11 points (must win by 2), deuce at 10-10
• Point-by-point: Available for live matches — great for real-time tracking
• Player profile: Nationality, world ranking, playing hand (R/L), grip style (shakehand/penhold)
• High volume: 2,283+ matches per day — use pagination and filters

​

Sport Comparison — Table Tennis vs Tennis