{
  "openapi": "3.0.1",
  "info": {
    "title": "Flashscore Scraper",
    "description": "Scrape Flashscore live scores, results, fixtures, match stats, goal scorers and head-to-head across football, tennis, basketball and 20+ sports. HTTP-only, MCP-ready.",
    "version": "1.0",
    "x-build-id": "q7kLlP6fztGPhIFMN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~flashscore-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~flashscore-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-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/khadinakbar~flashscore-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-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": {
          "sport": {
            "title": "Sport",
            "enum": [
              "football",
              "tennis",
              "basketball",
              "hockey",
              "american-football",
              "baseball",
              "handball",
              "rugby-union",
              "rugby-league",
              "floorball",
              "futsal",
              "volleyball",
              "cricket",
              "darts",
              "snooker",
              "boxing",
              "badminton",
              "water-polo",
              "table-tennis",
              "mma",
              "bandy",
              "beach-volleyball"
            ],
            "type": "string",
            "description": "Sport to scrape in list mode (by day). Defaults to 'football'. To scrape several sports in one run use 'sports' instead. For a sport not listed here, set the numeric 'sportId'.",
            "default": "football"
          },
          "sports": {
            "title": "Several sports (optional)",
            "type": "array",
            "description": "Scrape more than one sport in a single run, for example [\"football\",\"tennis\",\"basketball\"]. Overrides 'sport'. Each sport is read for every selected day.",
            "items": {
              "type": "string",
              "enum": [
                "football",
                "tennis",
                "basketball",
                "hockey",
                "american-football",
                "baseball",
                "handball",
                "rugby-union",
                "rugby-league",
                "floorball",
                "futsal",
                "volleyball",
                "cricket",
                "darts",
                "snooker",
                "boxing",
                "badminton",
                "water-polo",
                "table-tennis",
                "mma",
                "bandy",
                "beach-volleyball"
              ],
              "enumTitles": [
                "Football (Soccer)",
                "Tennis",
                "Basketball",
                "Ice Hockey",
                "American Football",
                "Baseball",
                "Handball",
                "Rugby Union",
                "Rugby League",
                "Floorball",
                "Futsal",
                "Volleyball",
                "Cricket",
                "Darts",
                "Snooker",
                "Boxing",
                "Badminton",
                "Water Polo",
                "Table Tennis",
                "MMA",
                "Bandy",
                "Beach Volleyball"
              ]
            }
          },
          "dayOffsets": {
            "title": "Day offsets",
            "type": "array",
            "description": "Which days to scrape in list mode, relative to today. 0 = today, -1 = yesterday's results, 1 = tomorrow's fixtures. Range -7 to 7. Example: [-1, 0, 1]. Ignored when 'date' or 'matchUrls' is set.",
            "default": [
              0
            ]
          },
          "date": {
            "title": "Exact date (optional)",
            "type": "string",
            "description": "Single calendar day to scrape in list mode, as YYYY-MM-DD (e.g. 2026-06-26). Must be within 7 days of today (Flashscore feed limit). Overrides 'dayOffsets'. Leave empty to use 'dayOffsets'."
          },
          "matchUrls": {
            "title": "Match URLs or IDs (detail mode)",
            "type": "array",
            "description": "Flashscore match URLs or raw 8-character match IDs to fetch full match detail for (statistics, lineups, incidents, head-to-head). Example: 'https://www.flashscore.com/match/football/2L651Hgn/' or '2L651Hgn'. When set, the Actor runs detail mode and ignores sport/day inputs. Matches with no detail yet (for example not played) are returned with detailAvailable=false and are not billed.",
            "items": {
              "type": "string"
            }
          },
          "detailSections": {
            "title": "Detail sections",
            "type": "array",
            "description": "Which sections to include for each match in detail mode (and when 'enrichListWithDetails' is on). Defaults to summary, statistics and incidents. Add 'h2h' for head-to-head history. 'lineups' is only returned when Flashscore supplies lineup data, which it currently rarely does.",
            "items": {
              "type": "string",
              "enum": [
                "summary",
                "stats",
                "incidents",
                "lineups",
                "h2h"
              ],
              "enumTitles": [
                "Summary",
                "Statistics",
                "Incidents (goals/cards/subs)",
                "Lineups",
                "Head-to-head"
              ]
            },
            "default": [
              "summary",
              "stats",
              "incidents"
            ]
          },
          "enrichListWithDetails": {
            "title": "Enrich list with match detail",
            "type": "boolean",
            "description": "In list mode, also fetch full match detail for every match returned and nest it under each record. Slower and bills one match-detail event per match that has detail data. Defaults to false.",
            "default": false
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on billable list rows or match details produced this run. Protects your budget. Defaults to 100. Set higher (up to 1,000,000) for full-day or multi-day pulls.",
            "default": 100
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Feed language code for team/league naming (e.g. 'en', 'es', 'de', 'fr'). Defaults to 'en'. This affects text labels only, not which matches are returned.",
            "default": "en"
          },
          "countries": {
            "title": "Countries (filter)",
            "type": "array",
            "description": "Only keep matches from these countries or regions, for example [\"Spain\",\"England\"]. Names as Flashscore shows them (case-insensitive). Leave empty for all.",
            "items": {
              "type": "string"
            }
          },
          "leagueContains": {
            "title": "League name contains",
            "type": "string",
            "description": "Only keep matches whose league or tournament name contains this text, for example 'Premier League' or 'ATP'. Case-insensitive."
          },
          "teamContains": {
            "title": "Team or player name contains",
            "type": "string",
            "description": "Only keep matches where the home or away team/player name contains this text, for example 'Barcelona' or 'Djokovic'. Case-insensitive."
          },
          "statuses": {
            "title": "Match status (filter)",
            "type": "array",
            "description": "Only keep matches in these states. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "scheduled",
                "live",
                "finished",
                "postponed",
                "cancelled",
                "abandoned",
                "interrupted",
                "walkover",
                "retired",
                "awaiting-updates",
                "delayed"
              ]
            }
          },
          "onlyLive": {
            "title": "Only live matches",
            "type": "boolean",
            "description": "Shortcut: keep only matches being played right now. Same as setting statuses to ['live'].",
            "default": false
          },
          "sportId": {
            "title": "Sport ID (advanced)",
            "minimum": 1,
            "type": "integer",
            "description": "Advanced override: Flashscore's numeric sport ID, used only for a sport not in the 'sport' dropdown. Example: 1 = football, 2 = tennis, 3 = basketball. Leave empty to use the 'sport' field."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy settings. Defaults to Apify Proxy (datacenter), which the Flashscore feed tolerates. Switch to residential only if you hit blocks.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}