Tennis Results & Live Scores (Flashscore, ATP, WTA, ITF)
Pricing
from $0.80 / 1,000 matches
Tennis results, live scores and schedules for ATP, WTA, Challenger and ITF: set-by-set scores with tiebreaks, round, surface, players with country and ranking, retirements and walkovers. Optional match stats. Unofficial, not affiliated with Flashscore. $0.80 per 1,000 matches.
matchId
Optional
Flashscore match ID (ESPN rows: "espn-" + ESPN match ID). Null on error rows
source
Optional
"flashscore" or "espn"
matchUrl
Optional
Match page on Flashscore (null on ESPN rows)
date
Optional
UTC date of the match start (YYYY-MM-DD). Flashscore lists a match on the day of its feed, which is close to but not exactly the UTC day (matches starting after 23:00 UTC are on the next day's list), so a day's rows can carry a neighbouring date. On error rows: the day the error is about
startTimeUtc
Optional
Start time, ISO 8601 UTC (null when ESPN has no confirmed time)
tour
Optional
ATP, WTA, Challenger (ATP Challenger and WTA 125), ITF, Teams, Exhibition, Mixed (Grand Slam mixed doubles, on both sources), or the category name for any other event Flashscore lists. Junior events are never returned
category
Optional
Category as the source names it, e.g. "ATP - Singles", "ITF Women - Doubles"
matchType
Optional
singles, doubles or team (Davis Cup / BJK Cup tie)
gender
Optional
men, women or mixed
tournament
Optional
Tournament name, e.g. "Almaty", "M15 Heraklion 9", "Wimbledon"
tournamentCountry
Optional
Country (or "World") of the tournament; ESPN country names are mapped to Flashscore's ("Great Britain" -> "United Kingdom", "China PR" -> "China")
tournamentCity
Optional
ESPN rows only: the venue city ESPN gives (ESPN names events after sponsors, e.g. "Grand Prix Auvergne-Rhône-Alpes" is in Lyon). Flashscore tournament names are already city names, so this is null on Flashscore rows
tournamentStage
Optional
"main" draw or "qualification" (null for team and other events)
round
Optional
Round as the source names it, e.g. "1/16-finals", "Quarter-finals", "Final", "Round 2". Null for live matches on Flashscore rows
surface
Optional
hard, clay, grass or carpet (null on ESPN rows)
indoor
Optional
Played indoors
tournamentId
Optional
Source tournament (season) ID
tournamentUrl
Optional
Tournament page
status
Optional
scheduled, live, finished, interrupted, postponed, cancelled or abandoned
statusDetail
Optional
Detailed state, e.g. "Set 2", "Set 3 - Tiebreak", "Finished / retired", "Walkover", "Delayed"
resultType
Optional
For finished matches: completed, retired, walkover or awarded
isRetirement
Optional
Finished because a player retired
isWalkover
Optional
Decided by walkover (not played)
homeName
Optional
Home side (first-named player; "A./B." for doubles)
awayName
Optional
Away side
homeCountry
Optional
Country of the home player ("USA/Italy" for a doubles pair)
awayCountry
Optional
Country of the away player
homeRanking
Optional
Current singles ranking of the home player (singles only; doubles rankings are in homePlayers)
awayRanking
Optional
Current singles ranking of the away player
homePlayers
Optional
Player(s) of the home side with country, ID, page and ranking
awayPlayers
Optional
Player(s) of the away side
setsHome
Optional
Sets won by the home side (rubbers for team ties)
setsAway
Optional
Sets won by the away side
score
Optional
Score from the home side: "7-6(5) 2-6 6-4"; the loser's tiebreak points in brackets, a match tiebreak as [10-7]
sets
Optional
Every set with games, tiebreak points and (with statistics) duration
winner
Optional
"home" or "away" (null if not decided)
winnerName
Optional
Name of the winning side
currentGameHome
Optional
Live only: points in the current game ("0", "15", "30", "40", "A")
currentGameAway
Optional
Live only: points of the away side in the current game
serving
Optional
Live only: "home" or "away"
durationMinutes
Optional
Match duration (only with "Include statistics")
statistics
Optional
Only with "Include statistics": {"match": {...}, "set1": {...}} with one entry per statistic (aces, doubleFaults, firstServePercentage, breakPointsConverted, ...): home / away values, plus homeTotal / awayTotal and homePercent / awayPercent where the source gives them
note
Optional
Source note, e.g. "Playing under a closed roof." or a withdrawal note
rankingList
Optional
Ranking list used for this match, e.g. "ATP singles"
rankingDate
Optional
Publication date of that ranking list (rankings are current, not as of the match day)
scrapedAt
Optional
When the run read the data (ISO 8601 UTC)
input
Optional
Error rows only: the date or input the error is about
error
Optional
Error rows only: what went wrong (free rows, never charged)
errorKind
Optional
Error rows only: invalid_input, not_covered, source_error or blocked
