ittf.com APIittf.com ↗
Access WTT event calendars, match results, player profiles, and world rankings via 4 endpoints covering official ITTF table tennis data.
curl -X GET 'https://api.parse.bot/scraper/d332c82e-1b62-499e-99ac-490db85dd8d3/get_events?year=2025' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the world table tennis event calendar for a specific year. Returns all scheduled and completed events including name, dates, location, and event type.
| Param | Type | Description |
|---|---|---|
| year | integer | The year to fetch events for. |
{
"type": "object",
"fields": {
"total": "integer count of events returned",
"events": "array of event objects containing EventName, EventType, Country, City, StartDateTime, EndDateTime, EventId, ContinentCode, and other metadata"
},
"sample": {
"data": {
"total": 194,
"events": [
{
"City": "Doha",
"Country": "Qatar",
"EventId": 3231,
"EventName": "WTT Champions Doha 2026",
"EventType": "WTT Champions",
"EndDateTime": "2026-01-11T00:00:00",
"EventTypeId": 65,
"ContinentCode": "asia",
"StartDateTime": "2026-01-07T00:00:00"
}
]
},
"status": "success"
}
}About the ittf.com API
The ITTF API exposes 4 endpoints covering official World Table Tennis event schedules, match results, and player data. Use get_events to pull a full-year event calendar with locations, dates, and event types, or get_event_results to retrieve game-level scores and match cards for any completed WTT event. Player-facing endpoints return bio fields like grip style, handedness, world ranking, and ranking points.
Event Calendar and Match Results
The get_events endpoint accepts a year integer and returns an array of event objects — each with EventName, EventType, Country, City, StartDateTime, EndDateTime, EventId, and ContinentCode. These EventId values feed directly into get_event_results, which returns up to 10 recent completed matches for that event including full match_card data with game scores, player names, match duration, and venue. Note that events without completed matches return a 404 rather than an empty result set.
Player Profiles and Rankings
get_player_details accepts an official ittf_id and returns a single player record with fields including PlayerName, DOB, Age, CountryName, Gender, Handedness, and Grip (e.g. Shakehand). This is useful for building player comparison tools or enriching match result data with biographical context.
get_featured_players requires no inputs and returns an array of currently featured athletes, each carrying fullName, ranking, rankingPoints, countryName, age, gender, and a nested additional_data block for season statistics. This is the fastest path to current world ranking data without needing a specific player ID.
- Build a WTT tournament tracker that surfaces upcoming and completed events by year and continent using
get_eventsfields likeContinentCodeandStartDateTime. - Display live match scorecards for a specific WTT event by querying
get_event_resultswith anevent_idand rendering thematch_carddata. - Enrich a player database with grip style, handedness, and nationality by fetching
get_player_detailsfor each ITTF ID. - Render a live world rankings widget using
get_featured_playerswithranking,rankingPoints, andcountryName. - Compare player biographies side-by-side by pulling
DOB,Handedness, andGripfields from multipleget_player_detailscalls. - Track a specific player's tournament appearances by cross-referencing their ITTF ID against event result data from
get_event_results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ITTF or World Table Tennis offer an official developer API?+
What does `get_event_results` return for events that haven't started yet?+
get_events to check StartDateTime and EndDateTime before calling get_event_results to avoid unnecessary requests.Can I look up a player's historical ranking over time or see their full match history?+
get_player_details returns current biographical data, and get_featured_players returns current ranking and season statistics — neither exposes historical ranking timelines or career match logs. You can fork this API on Parse and revise it to add endpoints targeting historical ranking or match history data.Does the event calendar cover all WTT event types, or only major championships?+
get_events returns all scheduled and completed events for the requested year, including event type via the EventType field. The response does not currently filter by tier or series, so all event categories in the calendar are included in a single array.Is there a way to search for players by name rather than by ITTF ID?+
get_player_details requires a known ittf_id, and get_featured_players returns a fixed set of featured athletes without a name-search parameter. You can fork this API on Parse and revise it to add a player search endpoint that accepts a name query.