Overview
Live scores, results, events, players and the world rankings from professional table tennis, as JSON over HTTPS. One key, 15 endpoints today, the same shape of answer everywhere.
Base address
https://api.tabletennisapi.com/v1FormatJSON, UTF-8
AuthKey in a header
HistorySince December 2024
Every answer has the same shape
A successful call returns data (an object or a list) and meta (counts, paging and notes). An error returns error with a short code and a plain message. Nothing else is ever at the top level.
200 OK
{
"data": [ ... ],
"meta": { "count": 50, "page": 1, "per_page": 50, "total": 214, "total_pages": 5 }
}What you can ask for
Matches
Live matches, any day's matches, one match with every game, yesterday's results.
Events
Past, running and scheduled events, their disciplines and their matches in order of play.
Players
Search by name or country; a player's record, match list and head to head.
Account
Your plan, today's calls and the dates your plan can read, without using an allowance.
Plans at a glance
| Free key | Live | Archive | Complete | |
|---|---|---|---|---|
| Calls a day | 50 | 20,000 | 20,000 | 50,000 |
| Calls a minute | 10 | 60 | 60 | 120 |
| Dates you can read | Yesterday to the days ahead | 1 January this year onward | All history, to yesterday | All history and ahead |
| Game scores, length, table | Empty | Yes | Yes | Yes |