{
"openapi": "3.0.1",
"info": {
"title": "Flashscore Scraper - Live Scores, Results & Fixtures",
"description": "Scrape Ahrefs public Top-Websites data for any domain: Domain Rating, organic search traffic, traffic value in USD, organic keyword count, linking websites with monthly change, top keyword, top country and organic competitors.",
"version": "0.1",
"x-build-id": "epBGAM6ThrSno4XkZ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~flashscore-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-flashscore-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/scrapesage~flashscore-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-flashscore-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/scrapesage~flashscore-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-flashscore-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": {
"sports": {
"title": "Sports",
"type": "array",
"description": "Which sports to scrape. Each sport is one lightweight page carrying every country and competition for that day. Leave empty and the run returns a small free sample.",
"items": {
"type": "string",
"enum": [
"football",
"tennis",
"basketball",
"hockey",
"handball",
"volleyball",
"baseball",
"american-football",
"rugby-union",
"others"
],
"enumTitles": [
"Football / Soccer",
"Tennis",
"Basketball",
"Ice hockey",
"Handball",
"Volleyball",
"Baseball",
"American football",
"Rugby union",
"Other sports"
]
}
},
"dayOffsets": {
"title": "Days",
"type": "array",
"description": "Which days to scrape, relative to today. Flashscore publishes roughly a week either side; days outside that window return nothing and are reported, not charged. Leave empty and the run returns a small free sample.",
"items": {
"type": "string",
"enum": [
"-7",
"-6",
"-5",
"-4",
"-3",
"-2",
"-1",
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7"
],
"enumTitles": [
"7 days ago",
"6 days ago",
"5 days ago",
"4 days ago",
"3 days ago",
"2 days ago",
"Yesterday",
"Today",
"Tomorrow",
"In 2 days",
"In 3 days",
"In 4 days",
"In 5 days",
"In 6 days",
"In 7 days"
]
}
},
"competitionFilter": {
"title": "Competitions",
"type": "array",
"description": "Keep only matches whose COUNTRY: Competition contains one of these, e.g. Premier League, ENGLAND, Champions League. Case-insensitive, matches on part of the name. Leave empty for every competition.",
"items": {
"type": "string"
}
},
"competitionsFromFile": {
"title": "Import competitions from a file (one per line)",
"type": "string",
"description": "Bulk-load the competition filter. Either paste the whole list (one per line), or give a single link to a public .txt/.csv, a Google Sheet or Drive share link, or an Apify key-value-store record. Blank lines, # comments, CRLF and a UTF-8 BOM all parse. A file that cannot be read stops the run with a clear message rather than silently scraping everything."
},
"statusFilter": {
"title": "Match status",
"type": "array",
"description": "Keep only matches in these states. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"finished",
"live",
"scheduled",
"postponed",
"cancelled"
],
"enumTitles": [
"Finished",
"Live now",
"Scheduled",
"Postponed",
"Cancelled"
]
}
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those - handy for lean CSV/Sheets exports. Nothing to memorise: open the dropdown and tick, or start typing (score, team) to filter.",
"items": {
"type": "string",
"enum": [
"type",
"matchId",
"url",
"sport",
"country",
"competition",
"standingsUrl",
"homeTeam",
"awayTeam",
"homeScore",
"awayScore",
"scoreDisplay",
"status",
"startTime",
"date",
"homeRedCards",
"awayRedCards",
"winner",
"totalGoals",
"scrapedAt"
],
"enumTitles": [
"Record type (type)",
"Match ID (matchId)",
"Match URL (url)",
"Sport (sport)",
"Country (country)",
"Competition (competition)",
"Standings URL (standingsUrl)",
"Home team (homeTeam)",
"Away team (awayTeam)",
"Home score (homeScore)",
"Away score (awayScore)",
"Score as shown (scoreDisplay)",
"Status (status)",
"Kick-off time (startTime)",
"Day (date)",
"Home red cards (homeRedCards)",
"Away red cards (awayRedCards)",
"Winner: home/away/draw (winner)",
"Total goals or points (totalGoals)",
"Scraped at (scrapedAt)"
]
}
},
"maxItems": {
"title": "Max matches",
"minimum": 1,
"type": "integer",
"description": "Maximum number of matches to output across all sports and days.",
"default": 1000
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. Flashscore serves the mobile scoreboard cleanly to Apify datacenter proxies, which are used by default. If you ever see blocks, switch to Residential.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}