{
"openapi": "3.0.1",
"info": {
"title": "Flashscore Tennis Scraper & API | ATP, WTA Live Scores, Odds",
"description": "Real-time tennis API and scraper for Flashscore: ATP and WTA live scores, tiebreaks, statistics and bookmaker odds. Challenger, ITF, singles and doubles. 54 fields per match, plus point by point and head-to-head. Past seasons too.",
"version": "0.0",
"x-build-id": "S9Ho3dRJkxivVyEhI"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~flashscore-tennis-api/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-flashscore-tennis-api",
"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/zen-studio~flashscore-tennis-api/runs": {
"post": {
"operationId": "runs-sync-zen-studio-flashscore-tennis-api",
"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/zen-studio~flashscore-tennis-api/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-flashscore-tennis-api",
"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": {
"dayOffsets": {
"title": "Days to fetch",
"type": "array",
"description": "Which days to collect, relative to today. 0 is today, -1 yesterday, 1 tomorrow. Pick several to cover a range.",
"items": {
"type": "string",
"enum": [
"-7",
"-6",
"-5",
"-4",
"-3",
"-2",
"-1",
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7"
],
"enumTitles": [
"7 days ago (-7)",
"6 days ago (-6)",
"5 days ago (-5)",
"4 days ago (-4)",
"3 days ago (-3)",
"2 days ago (-2)",
"Yesterday (-1)",
"Today (0)",
"Tomorrow (+1)",
"In 2 days (+2)",
"In 3 days (+3)",
"In 4 days (+4)",
"In 5 days (+5)",
"In 6 days (+6)",
"In 7 days (+7)"
]
},
"default": [
"0"
]
},
"matchStatuses": {
"title": "Match status",
"type": "array",
"description": "Keep only matches in these states. All returns everything. Live reflects the moment the run happens.",
"items": {
"type": "string",
"enum": [
"all",
"finished",
"live",
"scheduled"
],
"enumTitles": [
"All",
"Finished",
"Live",
"Scheduled"
]
},
"default": [
"all"
]
},
"tours": {
"title": "Tour",
"type": "array",
"description": "Keep only these tours. Leave empty for every tour.",
"items": {
"type": "string",
"enum": [
"atp",
"wta",
"challenger",
"itf",
"juniors",
"teams"
],
"enumTitles": [
"ATP",
"WTA",
"Challenger (men & women)",
"ITF (men & women)",
"Juniors (boys & girls)",
"Team events"
]
},
"default": []
},
"matchTypes": {
"title": "Singles or doubles",
"type": "array",
"description": "Keep only singles or only doubles. Leave empty for both.",
"items": {
"type": "string",
"enum": [
"singles",
"doubles"
],
"enumTitles": [
"Singles",
"Doubles"
]
},
"default": []
},
"tournaments": {
"title": "Tournament name",
"type": "array",
"description": "Keep only tournaments whose name contains one of these. Case-insensitive. Ignored when Tournament pages is filled in. Also names which tournaments to collect when Past seasons is set.",
"items": {
"type": "string"
},
"default": []
},
"startUrls": {
"title": "Tournament pages",
"type": "array",
"description": "Restrict the run to specific tournaments by pasting their Flashscore pages. Takes precedence over Tournament name.",
"default": [],
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"seasons": {
"title": "Past seasons",
"type": "array",
"description": "Collect finished seasons instead of a day of matches. Enter years, e.g. 2024. Fill in Tournament name as well: every named tournament is collected for every year listed here. A whole season comes back quickly, so this is the cheapest way to gather a lot of matches. Coverage differs by tournament and era — leave this empty for today's matches.",
"items": {
"type": "string"
}
},
"drawCategory": {
"title": "Which draw",
"type": "string",
"description": "One tournament name covers several draws: Wimbledon has men's and women's singles, three doubles draws and four junior draws. Enter WTA, ATP doubles, mixed, boys and so on to pick one. Leave empty for the men's singles."
},
"enrich": {
"title": "Extra detail per match",
"type": "array",
"description": "Add deeper data to every match. Each option makes a broad run take longer, so pick only what you need. Scores, set-by-set results and tiebreaks are always included without this.",
"items": {
"type": "string",
"enum": [
"summary",
"statistics",
"points",
"h2h",
"highlights",
"news",
"detail"
],
"enumTitles": [
"Umpire, venue & set durations",
"Match statistics (aces, serve %, break points, per set)",
"Point by point",
"Head-to-head history",
"Highlight videos",
"Related news",
"Total games & available data"
]
},
"default": []
},
"includeRounds": {
"title": "Round & seeding",
"type": "boolean",
"description": "Add the round each match belongs to (Final, Semi-finals, 1/8-finals...) and each player's tournament seeding. Adds very little time, however many matches you collect.",
"default": true
},
"includeRankings": {
"title": "Player rankings",
"type": "boolean",
"description": "Add each player's ATP or WTA ranking and points. Adds almost no time, however many matches you collect. Not applied to Past seasons: a ranking list is today's, so it would not be the player's rank at the time.",
"default": true
},
"includeOdds": {
"title": "Betting odds",
"type": "boolean",
"description": "Bookmaker odds for every match, including match winner, over/under, handicap, correct score and odd/even, with opening and current prices plus the best available price for every selection. Off by default because it makes a run slower.",
"default": false
},
"oddsMarkets": {
"title": "Odds markets",
"type": "array",
"description": "Whose bookmakers to return. Bookmakers are country-specific: almost every one operates in a single market, so pick the market(s) you can actually bet in. Each extra market makes the run slower.",
"items": {
"type": "string",
"enum": [
"GB",
"BR",
"IT",
"DE",
"ES",
"FR",
"US",
"AU",
"IN",
""
],
"enumTitles": [
"United Kingdom (20 bookmakers)",
"Brazil (29, mostly Brazilian)",
"Italy (13)",
"Germany (7)",
"Spain (9)",
"France (8)",
"United States (3)",
"Australia (2)",
"India (1)",
"International (major books only)"
]
},
"default": [
"GB"
]
},
"maxItems": {
"title": "Maximum matches",
"minimum": 1,
"type": "integer",
"description": "Stop after this many matches. Leave empty for no limit."
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}