Advanced Upcoming & Predictions APIs | Tennis API Documentation

Get All Upcoming Matches

GET/tennis/v2/upcoming/matches

Returns all upcoming scheduled matches across both ATP and WTA tours

Query Parameter

Parameter	Required	Description
`tournament`	No	Filter by tournament name. Example: tournament=EFG%20Swiss%20Open%20-%20Gstaad
`limit`	No	Number of rivalries to return (default: 10). Example: limit=10
`page`	No	Page number (default: 1). Example: page=1

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/upcoming/matches?tournament=EFG%20Swiss%20Open%20-%20Gstaad&limit=10&page=1' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Top Tennis Matches Today

GET/tennis/v2/upcoming/top-tennis-matches-today/{tour_type}

Returns the most significant matches scheduled today, ranked by importance

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Example Request: CURL

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

Get Match Prediction Data

GET/tennis/v2/upcoming/match-prediction/{tour_type}/{player1}/{player2}

Returns a data-driven prediction for an upcoming match between two players

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.
`player1`	Yes	First player display name (URL-encoded). E.g: Novak%20Djokovic
`player2`	Yes	Second player display name (URL-encoded). E.g: Jannik%20Sinner

Example Request: CURL

curl --request GET \
	--url 'https://tennis-api-atp-wta-itf.p.rapidapi.com/tennis/v2/upcoming/match-prediction/atp/Francesco Passaro/Martin Krumich' \
	--header 'X-RapidAPI-Host: tennis-api-atp-wta-itf.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'

Get Filters By Tour Type

GET/tennis/v2/upcoming/filters/{tour_type}

Returns available filter values (tournaments, rounds, surfaces) for upcoming matches

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Example Request: CURL

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

Get Filters All

GET/tennis/v2/upcoming/filters

Returns available all filter values (tournaments, rounds, surfaces) for upcoming matches

Example Request: CURL

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

Get Upcoming Matches By Tour Type

GET/tennis/v2/upcoming/matches/{tour_type}

Returns all upcoming scheduled matches by tour type.

Path Parameter

Parameter	Required	Description
`tour_type`	Yes	Tour category. Allowed values: `atp`, `wta`.

Query Parameter

Parameter	Required	Description
`group`	No	Filter by group. Enum("singles", "doubles"). Example: group=singles
`limit`	No	Number of rivalries to return (default: 10). Example: limit=10
`page`	No	Page number (default: 1). Example: page=1
`limit`	No	Number of rivalries to return (default: 10). Example: limit=10

Example Request: CURL

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