Tennis API · ATP · WTA · ITF

API Documentation

Welcome to the official Tennis API documentation. Access live and historical data for professional tennis across the ATP (men's), WTA (women's), and ITF tours — covering fixtures, player profiles, head-to-head records, rankings, and tournament information.

✅

Ready to integrate? Use the Getting Started guide to make your first request in under five minutes. All endpoints are available on RapidAPI.

Quick Start Video

Watch this short interactive guide to make your first API request in under five minutes.

🚀

Getting Started

Authentication, base URL, request format, and your first API call.

📅

Fixtures

Today's matches, fixtures by date range, tournament, or player.

👤

Players

Player profiles, match stats, surface summaries, titles and finals.

⚔️

Head-to-Head

All-time H2H records, match lists, per-tournament match stats.

🏆

Rankings

Current singles and doubles world rankings for ATP and WTA.

🎯

Tournaments

Tournament info, seasons, past champions, results and calendar.

🔧

Miscellaneous

Countries, court types, rounds, and full-text search.

Base URL

All API endpoints share the following base URL:

HTTP

https://tennis-api-atp-wta-itf.p.rapidapi.com

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`

ℹ️

Where to get your key Subscribe to the Tennis API on RapidAPI to receive your 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	10	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