{ "openapi": "3.0.1", "info": { "title": "Flashscore Tennis Scraper - Live Scores, Results & H2H", "description": "Flashscore tennis scraper for live scores, fixtures and results: ATP, WTA, Challenger and ITF, singles and doubles. Sets, tiebreaks, rankings, players, tournaments and surface, plus optional match stats, head-to-head (H2H) and point-by-point. Export to JSON, CSV or Excel or use the API.", "version": "1.0", "x-build-id": "ffFI3GYfeBde9c5Jb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/confidential_gnat~flashscore-tennis-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-confidential_gnat-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/confidential_gnat~flashscore-tennis-scraper/runs": { "post": { "operationId": "runs-sync-confidential_gnat-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/confidential_gnat~flashscore-tennis-scraper/run-sync": { "post": { "operationId": "run-sync-confidential_gnat-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": { "startUrls": { "title": "Flashscore tennis URLs", "type": "array", "description": "The tennis page (https://www.flashscore.com/tennis/) for all matches, a tour or tournament page such as https://www.flashscore.com/tennis/atp-singles/paris/ to keep only its matches, or a match page with ?mid= for one match.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max matches per URL", "minimum": 1, "type": "integer", "description": "Maximum matches saved for each start URL.", "default": 5 }, "daysBack": { "title": "Days back", "minimum": 0, "maximum": 7, "type": "integer", "description": "Also scrape the matches of this many days before today (0 to 7). Finished matches are listed for a week.", "default": 0 }, "daysAhead": { "title": "Days ahead", "minimum": 0, "maximum": 7, "type": "integer", "description": "Also scrape the fixtures of this many days after today (0 to 7).", "default": 0 }, "tours": { "title": "Tours", "type": "array", "description": "Keep only these tours. Empty means all.", "items": { "type": "string", "enum": [ "atp", "wta", "challenger", "itf", "other" ], "enumTitles": [ "ATP", "WTA", "Challenger", "ITF", "Other" ] } }, "matchStatuses": { "title": "Match status", "type": "array", "description": "Keep only scheduled, live or finished matches (finished includes retired and walkover). Empty means all.", "items": { "type": "string", "enum": [ "scheduled", "live", "finished" ], "enumTitles": [ "Scheduled", "Live", "Finished" ] } }, "matchType": { "title": "Singles or doubles", "enum": [ "all", "singles", "doubles" ], "type": "string", "description": "Keep singles, doubles or both.", "default": "all" }, "tournaments": { "title": "Tournament names", "type": "array", "description": "Keep only tournaments whose name contains one of these words, for example Paris or Roland Garros.", "items": { "type": "string" } }, "scrapeDetails": { "title": "Scrape match details", "type": "boolean", "description": "Adds the duration of each set and of the match, the referee and the match statistics (aces, double faults, serve and return points, break points, winners, errors) for matches that have started. Not available for scheduled matches.", "default": false }, "includeHeadToHead": { "title": "Include head-to-head", "type": "boolean", "description": "Adds the previous meetings of the two players and the last matches of each player.", "default": false }, "includePointByPoint": { "title": "Include point-by-point", "type": "boolean", "description": "Adds every game of every set for matches that have started: who served, who won, whether the serve was broken, the points of the game (0:15, 30:40...) with break, set and match points flagged, and the tiebreak points in order. Not available for scheduled matches or for some old or minor matches.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "No proxy is needed in normal use. Turn on Apify Proxy if your runs get blocked.", "default": { "useApifyProxy": false, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }