Tennis API · ATP · WTA · ITF
API Documentation
Welcome to the official Tennis API documentation.
Explore a complete range of endpoints covering player profiles, career statistics, match data, head-to-head records, fixtures, live scores, odds, predictions, rankings, tournaments and supporting tennis metadata.
The API includes detailed player profiles with match history, titles, finals, surface summaries, player photos and performance breakdowns, plus full career statistics with filters by year, surface, round, tournament and timeframe. Available stats include aces, serve and return performance, tiebreaks, deciding sets, average opponent ranking and more.
You can also access recent and historical match data, advanced H2H comparisons, fixtures and schedules, tournament draws, player rankings, search endpoints and tournament analytics. Coverage includes ATP, WTA, ITF, Grand Slam, Masters and Challenger-level data.
Premium endpoints include live tennis scores, event timelines, point-by-point data, real-time match updates, match odds, player odds, live in-play odds, historical odds, odds movement and tennis predictions for upcoming matches.
WebSocket access is available on the MEGA plan for real-time push updates covering live scores, odds and match events. Odds and prediction endpoints are available on ULTRA and MEGA plans, with historical odds coverage, including Marathon Bet and Pinnacle, plus pre-match and in-play odds from Marathon Bet, Pinnacle, bet365, DraftKings and MelBet.
Multiple Products Available
This documentation covers 5 different API products with different base URLs and features.
The endpoint paths and base URLs will change depending on which product(s) you subscribe to.
See the Base URLs section below for all 5 products and their paths.
If you need support, please contact us at [email protected]
Quick Start Video
Watch this short interactive guide to make your first API request in under five minutes.
Advanced APIs
Real-time Features
Base URLs — 5 Different Products
The Tennis API is split across 5 different products, each with its own base URL and RapidAPI subscription. Use the correct URL and host header for the product you're accessing:
IMPORTANT
If you are subscribed to our top level product "Tennis API - ATP WTA ITF" then absolutely ALL our endpoints are included in that, and you will have access to all of them (only some endpoints are limited to higher level plans). You can see this product here.
| Product | Base URL / X-RapidAPI-Host | Path Prefix |
|---|---|---|
| Tennis API - ATP WTA ITF All our endpoints from all sub products | Base URL: https://tennis-api-atp-wta-itf.p.rapidapi.comX-Host: tennis-api-atp-wta-itf.p.rapidapi.com | /tennis/v2/ |
| Tennis Stats API Profile, Advanced H2H, Tournament Analytics, Rankings, Search | Base URL: https://tennis-stats-api.p.rapidapi.comX-Host: tennis-stats-api.p.rapidapi.com | /tennis/v2/ms-api/ |
| Tennis Predictions API Upcoming Matches, Odds, Predictions, Top Matches | Base URL: https://tennis-predictions-api.p.rapidapi.comX-Host: tennis-predictions-api.p.rapidapi.com | /tennis/v2/ms-api/ |
| Tennis Live API Live Scores, Events, Point-by-Point, Odds | Base URL: https://tennis-live-api.p.rapidapi.comX-Host: tennis-live-api.p.rapidapi.com | /tennis/v2/extend/api/ |
| Tennis Live API (Socket.IO) Real-time push updates | YOUR_SOCKET_URL | WebSocket |
Versioning
The current API version is v2. All endpoints use the path prefix /tennis/v2/.
Tour Types
Most endpoints accept a {type} path parameter to select the tour:
| Value | Tour | Description |
|---|---|---|
atp | ATP | Association of Tennis Professionals (men's) |
wta | WTA | Women's Tennis Association |
Authentication
This API is distributed through RapidAPI. Every request must include two headers:
| Header | Value |
|---|---|
X-RapidAPI-Key | Your RapidAPI subscription key |
X-RapidAPI-Host | tennis-api-atp-wta-itf.p.rapidapi.com |
X-RapidAPI-Key. Free and paid tiers are available.
Rate Limits
A global throttle of 100 requests per minute per IP is enforced server-side. Exceeding this limit returns HTTP 429 Too Many Requests. Your RapidAPI plan may impose additional quota limits.
Error Codes
| HTTP Status | Meaning |
|---|---|
200 | Success — response body contains the data. |
400 | Bad Request — invalid parameters (e.g. wrong date format, invalid ID). |
401 | Unauthorized — missing or invalid X-RapidAPI-Key. |
403 | Forbidden — wrong host header or plan restriction. |
404 | Not Found — the resource or endpoint does not exist. |
429 | Too Many Requests — rate limit exceeded. |
500 | Internal Server Error — unexpected server issue. |
Endpoint Overview
| Module | Endpoints | Description |
|---|---|---|
| Fixtures | 6 | Match schedule and upcoming fixtures |
| Players | 11 | Player profiles and statistics |
| Head-to-Head | 6 | H2H records and match statistics |
| Rankings | 2 | Singles and doubles world rankings |
| Tournaments | 5 | Tournament info, seasons, calendar |
| Miscellaneous | 5 | Countries, courts, rounds, search |
| Tennis Stats API | 30+ | Profile, H2H, Tournament, Rankings & Search |
| Tennis Predictions API | 7 | Upcoming matches, odds, predictions |
| Tennis Live API | 4 | Live events, live scores, point-by-point |