Skip to main content
Professional padel generates detailed statistics for every match. The Padel API organizes this data at three levels: match, player, and pair. Each level answers different questions.

Match Stats

Point-by-point breakdown: serve %, break points, streaks, set-by-set data.

Player Stats

Career aggregates: win rate, titles, finals, best round.

Pair Stats

Combined performance: how a specific duo performs together.

Match statistics

The most granular level. Every match with available data includes stats for both teams, broken down by set. Endpoint: GET /api/matches/{match_id}/stats.
A match stats response includes overall totals plus per-set breakdowns:

Available metrics per set

Set-by-set data lets you track momentum shifts. A team winning 77% on serve in set 3 after 59% in set 1 tells a story that the match total alone doesn’t.

Player statistics

Career-level aggregates for any player. Useful for comparing trajectories, building rankings models, or analyzing form over specific periods. Endpoint: GET /api/players/{player_id}/stats.

Filtering by date range

Player stats accept after_date and before_date parameters to calculate stats over a specific period. This is useful for season-by-season comparisons or tracking form over time.

Filtering by round

Use the round parameter to isolate performance at specific tournament stages.
Comparing a player’s win percentage in early rounds vs finals reveals how they perform under pressure. Some players dominate early rounds but underperform in decisive matches, and vice versa.

Pair statistics

Padel is a doubles sport, and individual numbers only tell part of the story. Pair stats measure how two specific players perform together. Endpoint: GET /api/pairs/{player_1_id}-{player_2_id}/stats.
Pair stats also support after_date, before_date, and round filters, just like player stats.

What pair stats reveal

The gap between a player’s individual stats and their pair stats exposes partner chemistry. A player with an 80% win rate overall but 90% with a specific partner suggests that pairing is greater than the sum of its parts. Compare pairs across:
  • Win percentage to find the most dominant duos
  • Titles vs finals to measure conversion rate in decisive matches
  • Average games per match as a proxy for match difficulty (lower = more dominant wins)

Common use cases

Building a player comparison dashboard

Combine player stats with date filters to create season-by-season comparisons:

Analyzing serve dominance in a match

Extract serve and return metrics to understand match dynamics:

Tips

Match statistics depend on official data availability. Major and P1 tournaments typically have full stats coverage, while lower-level tournaments may not. Check the response before assuming data exists.
When two player records are merged, the API returns a 302 redirect to the canonical player. Handle redirects in your HTTP client to avoid broken references.
Before writing code, you can explore stats interactively using Padel Analyst. Ask questions like “What’s Coello’s win percentage in finals?” or “Show me match stats for the latest Major final” to find what you need.

Next steps

Player Stats Endpoint

Full reference for career win rate, titles and progression

Match Stats Endpoint

Serve %, break points and streaks, set by set

Pair Stats Endpoint

How a specific duo performs together

Your First API Call

Get set up with authentication and basic requests

Padel Analyst

Explore stats in natural language with AI assistants