{
"openapi": "3.0.1",
"info": {
"title": "Flashscore Tennis Scraper — Matches, Stats, Points & H2H",
"description": "Every tennis match of a day from Flashscore — ATP, WTA, Challenger, ITF, doubles, Davis Cup — with scores, players, rankings and tournament. Add match statistics, point-by-point and head-to-head for the whole day in the same run. Filter by player, tournament, tour or status. No browser, no login.",
"version": "1.0",
"x-build-id": "2aMrHMdTgwO6el5vZ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyscrape~flashscore-tennis-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyscrape-flashscore-tennis-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/steadyscrape~flashscore-tennis-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyscrape-flashscore-tennis-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/steadyscrape~flashscore-tennis-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyscrape-flashscore-tennis-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"dateFrom": {
"title": "From day",
"type": "string",
"description": "today, yesterday, tomorrow, a number of days from today (-3, +2) or a date (2026-09-19). Relative days are what a scheduled run wants. Flashscore publishes days up to a week either side of today.",
"default": "today"
},
"dateTo": {
"title": "To day",
"type": "string",
"description": "Last day of the range, written like From day. Leave empty for a single day."
},
"utcOffsetHours": {
"title": "Your UTC offset (hours)",
"minimum": -12,
"maximum": 14,
"type": "integer",
"description": "Where a day starts and ends: 0 cuts days at UTC, -5 at New York time, 2 at Central European summer time. Match times in the output are always UTC.",
"default": 0
},
"matches": {
"title": "Matches (instead of days)",
"type": "array",
"description": "Flashscore match links, or the eight-character match ids the output gives as matchId. When this list is not empty the days and the filters are ignored.",
"items": {
"type": "string"
}
},
"matchStatus": {
"title": "Match status",
"type": "array",
"description": "Leave empty for all. finished includes retirements and walkovers; live includes interrupted matches; cancelled includes postponed ones.",
"items": {
"type": "string",
"enum": [
"scheduled",
"live",
"finished",
"cancelled"
],
"enumTitles": [
"Scheduled",
"Live",
"Finished",
"Cancelled or postponed"
]
}
},
"tours": {
"title": "Tours",
"type": "array",
"description": "Leave empty for all.",
"items": {
"type": "string",
"enum": [
"atp",
"wta",
"challenger_men",
"challenger_women",
"itf_men",
"itf_women",
"teams",
"juniors",
"exhibition",
"other"
],
"enumTitles": [
"ATP",
"WTA",
"Challenger men",
"Challenger women",
"ITF men",
"ITF women",
"Team ties (Davis Cup, BJK Cup)",
"Juniors",
"Exhibition",
"Other"
]
}
},
"matchTypes": {
"title": "Singles or doubles",
"type": "array",
"description": "Leave empty for all.",
"items": {
"type": "string",
"enum": [
"singles",
"doubles",
"teams"
],
"enumTitles": [
"Singles",
"Doubles",
"Team ties"
]
}
},
"tournaments": {
"title": "Tournaments",
"type": "array",
"description": "Part of a tournament name: Wimbledon, Roland Garros, M15 Monastir. Case and accents do not matter.",
"items": {
"type": "string"
}
},
"players": {
"title": "Players",
"type": "array",
"description": "Part of a player name as Flashscore lists it, usually the surname: Alcaraz, Swiatek. Case and accents do not matter.",
"items": {
"type": "string"
}
},
"includeStatistics": {
"title": "Match statistics",
"type": "boolean",
"description": "Aces, double faults, serve and return percentages, break points, points and games won — for the match and for each set, each with its number and its fraction (80% (44/55) → 80, 44, 55).",
"default": false
},
"includePointByPoint": {
"title": "Point by point",
"type": "boolean",
"description": "Every game with its server, winner, breaks of serve and the score after each point, with break points, set points and match points marked; tiebreaks point by point.",
"default": false
},
"includeHeadToHead": {
"title": "Head-to-head and recent form",
"type": "boolean",
"description": "Previous meetings of the two sides and the last matches of each, with surface, score and winner. Available before the match starts, which is when a model needs it.",
"default": false
},
"includeOdds": {
"title": "Betting odds",
"type": "boolean",
"description": "Every bookmaker's prices for the match, each with its opening price: match winner, set winner, over/under, Asian handicap, correct score and odd/even. Available before the match starts.",
"default": false
},
"oddsCountry": {
"title": "Bookmakers of (country)",
"pattern": "^[A-Za-z]{2}$",
"type": "string",
"description": "Two-letter country code: Flashscore lists the bookmakers licensed there. GB has the most (about 20: bet365, William Hill, Ladbrokes, Betfair…); US has FanDuel, DraftKings and BetMGM; try DE, IT, BR, AU… An unknown code gets an international set.",
"default": "GB"
},
"oddsRegion": {
"title": "Region of the country",
"pattern": "^[A-Za-z0-9]{0,6}$",
"type": "string",
"description": "For countries that license by state. USNY adds the bookmakers of New York to those of the US. Leave empty otherwise."
},
"oddsMarkets": {
"title": "Odds markets",
"type": "array",
"description": "Which markets to keep. Leave empty for all of them.",
"items": {
"type": "string",
"enum": [
"winner",
"over_under",
"asian_handicap",
"correct_score",
"odd_even"
],
"enumTitles": [
"Winner (match and each set)",
"Over/under (games, sets)",
"Asian handicap",
"Correct score",
"Odd/even total games"
]
},
"default": [
"winner"
]
},
"recentMatchesPerPlayer": {
"title": "Recent matches per player",
"minimum": 0,
"maximum": 50,
"type": "integer",
"description": "How many of each side's last matches the head-to-head carries.",
"default": 10
},
"maxMatches": {
"title": "Maximum matches",
"minimum": 0,
"type": "integer",
"description": "Stops after this many matches, earliest first. 0 for no limit. Your run's maximum charge is respected either way.",
"default": 0
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}