Advanced API

Advanced API Overview

The Advanced API provides a richer, deeper set of tennis data endpoints beyond the core API. It covers detailed player analytics, live match tracking, match predictions, advanced H2H breakdowns, full season calendars, potential fixture combinations, and global search — all accessible through the same RapidAPI subscription.

ℹ️

Same authentication All Advanced API endpoints use the exact same X-RapidAPI-Key and X-RapidAPI-Host headers as the core API. No additional credentials are required.

Base URLs (Product-Based)

⚠️

Important: Advanced API endpoints are split across separate RapidAPI products. You must use the correct base URL and X-RapidAPI-Host for each product.

Product	Base URL	Modules	Plan Required
Tennis Stats API	`https://tennis-stats-api.p.rapidapi.com`	Profile, H2H, Rankings, Search, Tournament, Calendar, Potential Fixtures, Interesting H2H	Pro+
Tennis Predictions API	`https://tennis-predictions-api.p.rapidapi.com`	Upcoming Matches, Match Prediction, Match Odds, Top Matches	Ultra & Mega
Tennis Live API	`https://tennis-live-api.p.rapidapi.com`	Live Events, Live Score, Point-by-Point, Live Odds	Ultra & Mega
Socket.IO	`wss://live.matchstat.com`	Real-time push updates	Mega only

Authentication

Set the X-RapidAPI-Host header to match the product you are calling:

Header	Value
`X-RapidAPI-Key`	Your RapidAPI subscription key
`X-RapidAPI-Host`	The host for the product (e.g. `tennis-stats-api.p.rapidapi.com`)

Tour Types

Most endpoints require a {type} path parameter specifying the tour:

Value	Tour
`atp`	Men's tour (ATP)
`wta`	Women's tour (WTA)

ℹ️

Player name format Endpoints that accept a {name} path parameter expect the player name in lastname-firstname lowercase hyphenated format.
Example: djokovic-novak, swiatek-iga, alcaraz-carlos

Available Modules

👤

Profile

Detailed player profiles, season statistics, surface win rates, performance breakdowns, match history, finals records, and player search.

⚔️

H2H Advanced

Deep head-to-head analytics — aggregated stats, full match history, surface breakdown, rivalries, upcoming meetings, and recent event data.

📡

Upcoming & Predictions

Upcoming scheduled matches with odds, AI-powered match predictions, and top matches today.

Ultra & Mega 📺

Live Events & Scores

Live event feeds, live score tracking, point-by-point statistics, and live odds updates.

Ultra & Mega 🏟️

Tournament Advanced

Tournament draws, points, seeds, past champions, all-time most victories, full season calendars, Grand Slam history, and potential fixture combinations.

🔍

Rankings & Search

Advanced ranking lists with country filters, Top 10 snapshots, Top 500 name lookup, full ranking history per player, and full-text search across players and tournaments.

🔌

Socket.IO Integration

Real-time push updates for live scores, odds, and match events via WebSocket.

Mega Plan

Module Summary

Module	Product	Base Path	Endpoints
Profile	`tennis-stats-api`	`.../ms-api/profile/`	13
H2H Advanced	`tennis-stats-api`	`.../ms-api/h2h/`	16
Interesting H2H	`tennis-stats-api`	`.../ms-api/interesting-h2h/`	1
Upcoming & Predictions	`tennis-predictions-api`	`.../ms-api/upcoming/`	7
Live	`tennis-live-api`	`.../ms-api/live-events/` + `live-score/` + `pbp-stat/`	4
Tournament Advanced	`tennis-stats-api`	`.../ms-api/tournament/` + `calendar/` + `potential-fixtures/`	15
Rankings & Search	`tennis-stats-api`	`.../ms-api/ranking/` + `search/`	7

Quick Example

Stats API Example (Profile)

cURL

curl --request GET \
  --url 'https://tennis-stats-api.p.rapidapi.com/tennis/v2/ms-api/profile/Carlos%20Alcaraz' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-stats-api.p.rapidapi.com'

Predictions API Example (Upcoming Matches)

cURL

curl --request GET \
  --url 'https://tennis-predictions-api.p.rapidapi.com/tennis/v2/ms-api/upcoming/matches/atp' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-predictions-api.p.rapidapi.com'

Live API Example (Live Events)

cURL

curl --request GET \
  --url 'https://tennis-live-api.p.rapidapi.com/tennis/v2/ms-api/live-events/atp' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: tennis-live-api.p.rapidapi.com'