Tennis Rankings, Matches & Tournaments Scraper

Extract ATP rankings, Elo ratings, complete match histories and tournament results. No API key, no login, no scraping of rendered pages — this reads a structured JSON source directly.

---

Why this scraper

Elo ratings, not just official rankings. Official points reward showing up; Elo measures actual strength and predicts matches far better. Both are one setting apart here.

Complete match histories. Every match a player has contested, with surface, round, tournament tier, score and opponent — filterable by surface, level and season. That is the shape you need for form analysis and modelling.

Readable codes. The source returns H, C, G for surfaces and G, M, A for tournament levels. This Actor translates them to Hard, Clay, Grass and Grand Slam, Masters, ATP 500 — so a CSV is usable without a lookup table.

---

What you can extract

Mode	What you get
World rankings	Rank, points, movement since the last update, career-best rank and points — official or Elo
Matches of a player	Every match with date, tournament, tier, round, surface, opponent, score, and whether your player won
Tournaments	Draw size, field strength, average Elo of the field, winner, runner-up and final score
Find a player	Look up the numeric player ID you need for the match mode

---

Quick start

1. Start with Find a player and search a name — you get the player ID.
2. Switch to Matches of a player and paste that ID.
3. Set Maximum results, click Start, download as CSV or JSON.

For rankings you can skip straight to World rankings.

---

Example inputs

Top 500 of the current ATP ranking

{
  "mode": "rankings",
  "maxItems": 500
}

Elo ratings — who is actually playing best

{
  "mode": "rankings",
  "rankingType": "ELO_RANK",
  "maxItems": 200
}

A player's full clay-court record

{
  "mode": "playerMatches",
  "playerIds": ["52602"],
  "surface": "C",
  "maxItems": 500
}

Grand Slam matches of several players

{
  "mode": "playerMatches",
  "playerIds": ["52602", "4742", "3819"],
  "level": "G",
  "maxItems": 1500
}

Every tournament of a season

{
  "mode": "tournaments",
  "season": "2024",
  "maxItems": 200
}

Look up a player ID

{
  "mode": "searchPlayers",
  "searchQuery": "Alcaraz"
}

---

Output fields

Rankings

Field	Description
rank	Current position
name, playerId, url	Who, and the ID for the match mode
country, countryCode	Nation represented
points	Ranking points, or Elo rating in Elo mode
rankChange	Movement since the last ranking — negative means the player climbed
pointsChange	Points gained or lost
bestRank, bestRankDate, bestPoints	Career highs
rankingType	Official or Elo

Matches

Field	Description
date, tournament, tournamentId	When and where
level, levelCode	Grand Slam, Masters, ATP 500 …
round	Final, Semifinal, Round of 16 …
surface, indoor	Hard, Clay, Grass, Carpet, and whether indoors
bestOf, score	Format and final score
winnerName, winnerId, winnerCountry, winnerSeed	Who won
loserName, loserId, loserCountry, loserSeed	Who lost
queriedPlayerWon	Whether the player you asked about won — no name matching needed
hasDetailedStats	Whether serve and return statistics exist for the match

Tournaments

Field	Description
name, date, season, url	Identity
level, surface, indoor	Tier and conditions
drawType, drawSize, playerCount	Format
participationPercent, fieldStrength, averageEloRating	How strong the field really was
winnerName, runnerUpName, finalScore	Outcome

---

Limits

• ATP only. The underlying source covers men's tennis; there is no WTA data.
• Tournament history ends in 2024. Rankings and match records go further, but the tournament tables have not been extended past that season.
• Player IDs are internal. They are not ATP IDs — use the player search mode to find them.
• Live scores are not included. This is historical and ranking data, not in-play coverage.

---

FAQ

Do I need an API key? No. The source exposes structured JSON publicly.

What is the difference between official rankings and Elo? Official points depend on which tournaments a player entered. Elo is calculated from results against rated opponents, which makes it a better predictor.

How do I find a player ID? Run the Find a player mode with the surname. The playerId column is what the match mode expects.

Can I get several players at once? Yes. Pass multiple IDs; the result budget is split evenly between them.

What formats can I export? CSV, Excel, JSON, XML, or straight from the Apify API.

---

Legal and responsible use

This Actor reads publicly available sports statistics. Match results and rankings are factual records, not personal data in the sensitive sense — but player names are still personal data under GDPR, and you remain responsible for how you use and republish the output.