{ "openapi": "3.0.1", "info": { "title": "Flashscore Sports Data API — 58 record types, 40 sports", "description": "The most comprehensive Flashscore data API on Apify. Live scores, fixtures, results, match events, statistics, lineups, H2H, standings, team and player profiles, transfers, injuries, rankings, season calendars, search and news. Production-ready JSON, CSV or Excel. Unofficial.", "version": "1.0", "x-build-id": "oy0vuT1lAqJvplUNR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/joaobrito~flashscore-sports-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-joaobrito-flashscore-sports-data-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/joaobrito~flashscore-sports-data-api/runs": { "post": { "operationId": "runs-sync-joaobrito-flashscore-sports-data-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/joaobrito~flashscore-sports-data-api/run-sync": { "post": { "operationId": "run-sync-joaobrito-flashscore-sports-data-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", "required": [ "mode", "maxItems", "maxConcurrency" ], "properties": { "mode": { "title": "Extraction mode", "enum": [ "live", "matchesByDate", "matchDetails", "countries", "featuredCompetitions", "bookmakers", "search", "topSearch", "newsLocales", "newsCategories", "news", "standings", "rankings", "seasonCalendars", "team", "player", "competition", "h2h" ], "type": "string", "description": "Choose what type of data to extract. Bookmakers mode is betting-adjacent, must be used only where permitted, and is not an odds feed.", "default": "live" }, "sports": { "title": "Sports", "type": "array", "description": "Sports to extract. In search and topSearch modes this is a local post-filter because the upstream search service ignores sport parameters. In countries and featuredCompetitions modes, pass an empty array to collect every supported sport catalog. In bookmakers mode, sports is ignored. Country competition expansion is controlled by Include country competitions. In news mode, prefer newsCategoryKeys returned by newsCategories; sports is only used as the fallback feed when no newsCategoryKeys are provided.", "items": { "type": "string", "enum": [ "football", "tennis", "basketball", "hockey", "american-football", "baseball", "handball", "rugby", "floorball", "bandy", "futsal", "volleyball", "cricket", "darts", "snooker", "boxing", "beach-volleyball", "aussie-rules", "rugby-league", "badminton", "water-polo", "golf", "field-hockey", "table-tennis", "beach-soccer", "mma", "netball", "pesapallo", "motorsport", "motorsport-auto-racing", "motorsport-moto-racing", "cycling", "horse-racing", "esports", "winter-sports", "winter-sports-ski-jumping", "winter-sports-alpine-skiing", "winter-sports-cross-country", "winter-sports-biathlon", "kabaddi" ] }, "default": [ "football" ] }, "dateFrom": { "title": "Date from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Start date in YYYY-MM-DD. Used in matchesByDate mode." }, "dateTo": { "title": "Date to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "End date in YYYY-MM-DD. Keep ranges small in the MVP." }, "targetUrls": { "title": "Target URLs", "maxItems": 1000, "type": "array", "description": "Match, team, player, ranking, public season calendar, public competition page or full Flashscore News category URLs to extract, depending on mode. Only flashscore.com URLs are accepted. In rankings mode, use URLs such as https://www.flashscore.com/tennis/rankings/atp/, https://www.flashscore.com/football/rankings/fifa/, https://www.flashscore.com/golf/rankings/owgr/ or https://www.flashscore.com/badminton/rankings/bwf-singles-men/. In seasonCalendars mode, use URLs such as https://www.flashscore.com/tennis/calendar/atp/ or https://www.flashscore.com/golf/calendar/pga/. In player mode, use URLs such as https://www.flashscore.com/player/gyokeres-viktor/zaBZ1xIk/. For news mode, use mode newsCategories first to discover supported URLs.", "items": { "type": "string", "pattern": "^https?://([a-z0-9-]+\\.)*flashscore\\.com(/.*)?$", "maxLength": 500 }, "default": [] }, "matchIds": { "title": "Match IDs", "maxItems": 1000, "type": "array", "description": "Optional Flashscore match IDs if known.", "items": { "type": "string", "pattern": "^[A-Za-z0-9]{6,16}$" }, "default": [] }, "searchQueries": { "title": "Search queries", "maxItems": 200, "type": "array", "description": "Search terms for mode search. Each query must be at least 2 characters. Use topSearch for popular suggestions without a query.", "items": { "type": "string", "minLength": 2, "maxLength": 200 }, "default": [] }, "searchLimit": { "title": "Search limit", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum search results requested per query or top-search task. Flashscore currently supports useful limits up to 50.", "default": 20 }, "searchTypes": { "title": "Search result types", "type": "array", "description": "Optional post-filter for search results. Leave empty to return teams, players and competitions.", "items": { "type": "string", "enum": [ "team", "player", "competition" ] }, "default": [] }, "allNewsProjects": { "title": "All news projects", "type": "boolean", "description": "In news article mode, collect broad locale coverage while deduplicating equivalent sources internally. In newsCategories mode, fetch every known public news menu.", "default": false }, "newsProjectIds": { "title": "News project IDs", "type": "array", "description": "Advanced selector for exact public Flashscore News project ids. Prefer newsLocales for normal use; use mode newsLocales to discover supported locale/project combinations.", "items": { "type": "integer", "minimum": 1 }, "default": [] }, "newsLocales": { "title": "News locales", "type": "array", "description": "Exact Flashscore news locales to use, such as pt, pt-br, en-uk or es-mx. Use mode newsLocales to list available values.", "items": { "type": "string" }, "default": [] }, "newsCategoryKeys": { "title": "News category keys", "type": "array", "description": "Optional news category keys returned by mode newsCategories, such as all:all, SPORT:SW9D1eZo or TAG:C8OAR7gM. In news mode, categories are combined with each selected news locale.", "items": { "type": "string" }, "default": [] }, "includeCountryCompetitions": { "title": "Include country competitions", "type": "boolean", "description": "In countries mode, fetch leagues and tournaments inside each discovered country/category.", "default": true }, "countryCompetitionConcurrency": { "title": "Country competition concurrency", "minimum": 1, "maximum": 3, "type": "integer", "description": "Maximum concurrent competition requests inside each countries task.", "default": 2 }, "competitionArchiveSeasons": { "title": "Competition archive seasons", "minimum": 0, "maximum": 10, "type": "integer", "description": "In competition mode, fetch historical standings/draw feeds for this many previous seasons from the public archive. Keep low because each season can expose multiple stage feeds.", "default": 0 }, "competitionOddsGeoIpCode": { "title": "Competition odds geo IP code", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter ISO 3166-1 alpha-2 country code used for competition winner odds. Odds availability is geo-dependent; GB usually exposes public winner odds when available.", "default": "GB" }, "competitionOddsGeoIpSubdivisionCode": { "title": "Competition odds subdivision code", "pattern": "^[A-Za-z0-9-]{0,16}$", "type": "string", "description": "Optional subdivision code (ISO 3166-2 style) used by Flashscore winner odds requests.", "default": "" }, "oddsGeoIpCode": { "title": "Match odds geo IP code", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Legacy match-odds geo country code (ISO 3166-1 alpha-2). If set, the actor derives coverage targets from oddsProjectIds and this geo instead of using the default multi-geo target list.", "default": "PT" }, "oddsGeoIpSubdivisionCode": { "title": "Match odds subdivision code", "pattern": "^[A-Za-z0-9-]{0,16}$", "type": "string", "description": "Legacy match-odds subdivision code (ISO 3166-2 style). Used with oddsGeoIpCode when deriving legacy coverage targets.", "default": "PT13" }, "oddsProjectIds": { "title": "Match odds project IDs", "type": "array", "description": "Legacy match-odds project fan-out. Leave empty to use oddsCoveragePreset or oddsCoverageTargets. If supplied, each project id is requested with oddsGeoIpCode and oddsGeoIpSubdivisionCode.", "items": { "type": "integer" }, "default": [] }, "oddsCoveragePreset": { "title": "Match odds coverage preset", "enum": [ "primary", "balanced", "extended", "global", "max" ], "type": "string", "description": "Match-odds geo fan-out (only matters when include.odds is true; include.odds defaults to false). Primary (the default) makes a single request to projectId=2 / geo=GB and returns 20 mainstream international bookmakers (bet365, Betfair, William Hill, Ladbrokes, Paddy Power, Skybet, Betway, BetVictor, BetMGM, Betfred, Coral, Unibetuk, BetUK, Betano.uk, 10bet, 7Bet, Midnite, Parimatch.uk, SpreadEX, Talksportbet) in one match_odds record at $0.005. Use Balanced (14 geos), Extended (20 geos adds FI, ZA, NL, NO, BE, DE), Global (28 geos) or Max (48 geos) to fan out across regional bookmakers — each geo adds one match_odds record per match. Heads-up: Pinnacle is not in Flashscore's commercial bookmaker network (validated 2026-05-20 across 186 request patterns — 62 geo × projectId odds combinations and the full 137-bookmaker catalog dump). Higher presets multiply volume without unlocking new bookmaker brands. Ignored when oddsCoverageTargets or legacy odds controls are supplied.", "default": "primary" }, "oddsCoverageTargets": { "title": "Match odds coverage targets", "type": "array", "description": "Advanced, compliance-sensitive match-odds coverage control. Each target combines a public project id and geo. When supplied, this overrides oddsCoveragePreset but still does not enable odds output unless include.odds and the odds compliance gate are enabled. The default balanced preset uses projectId 2 across multiple geos for broader bookmaker coverage at similar request cost.", "items": { "type": "object", "required": [ "projectId", "geoIpCode" ], "properties": { "projectId": { "title": "Project ID", "description": "Public Flashscore project id for this odds coverage target.", "type": "integer", "minimum": 1 }, "geoIpCode": { "title": "Geo IP country code", "description": "Two-letter country code used for this odds coverage target.", "type": "string" }, "geoIpSubdivisionCode": { "title": "Geo IP subdivision code", "description": "Optional subdivision code used for this odds coverage target.", "type": "string", "default": "" } } }, "default": [ { "projectId": 2, "geoIpCode": "PT", "geoIpSubdivisionCode": "PT13" }, { "projectId": 2, "geoIpCode": "BR", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "GB", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "ES", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "FR", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "RO", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "AT", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "PL", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "NG", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "CZ", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "DK", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "SE", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "IT", "geoIpSubdivisionCode": "" }, { "projectId": 2, "geoIpCode": "GR", "geoIpSubdivisionCode": "" } ] }, "maxItemsPerNewsTask": { "title": "Maximum news items per task", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Optional per-locale/category cap for news article collection. The global Maximum results cap still applies to the whole run." }, "resolveNewsCategoryMetadata": { "title": "Resolve news category metadata", "type": "boolean", "description": "When using newsCategoryKeys, fetch the public news menu once per task to enrich article topics with localized category names. Leave disabled to keep first-page article collection GraphQL-only.", "default": false }, "rankingScope": { "title": "Ranking scope", "enum": [ "targets", "relatedTabs", "allKnown" ], "type": "string", "description": "In rankings mode, choose whether to collect only targetUrls, expand related ranking tabs from those URLs, or collect all known public ranking families and their tabs. allKnown covers confirmed public rankings for football/FIFA, tennis, golf, darts, snooker and badminton.", "default": "targets" }, "include": { "title": "Detail modules", "type": "object", "description": "Choose optional implemented sections. Odds are advanced and compliance-sensitive: include.odds is disabled by default and only enables geo-dependent odds when legal/product approval and the environment gate allow it. In player, team and competition modes, news enables participant or competition news articles; in rankings mode, liveRankings enables tennis live ranking projections from ral_* feeds. articleContent is also compliance-sensitive, disabled by default, and requires its matching environment gate before full public output is emitted.", "properties": { "commentary": { "title": "Commentary", "type": "boolean", "description": "Include public text commentary when the match exposes it.", "default": false }, "events": { "title": "Events", "type": "boolean", "description": "Include match event rows when available.", "default": false }, "highlights": { "title": "Highlights metadata", "type": "boolean", "description": "Include public highlight metadata when available and permitted.", "default": false }, "statistics": { "title": "Statistics", "type": "boolean", "description": "Include match statistics when available.", "default": false }, "lineups": { "title": "Lineups", "type": "boolean", "description": "Include lineups when available.", "default": false }, "h2h": { "title": "Head-to-head", "type": "boolean", "description": "Include head-to-head match rows when available.", "default": false }, "momentum": { "title": "Momentum", "type": "boolean", "description": "Include match momentum data when available.", "default": false }, "odds": { "title": "Odds", "type": "boolean", "description": "Public match and competition odds across the bookmakers Flashscore's commercial feed exposes. Default OFF — opt in explicitly. With the default 'primary' oddsCoveragePreset (1 GB request, single match_odds record per match) cost is $0.005 per match; 20 mainstream international bookmakers and ~860 market/scope rows are nested inside that one record. Use balanced/extended/global/max for additional regional bookmakers (each geo adds one extra match_odds record per match). Pinnacle is not in Flashscore's bookmaker network — validated across 186 request patterns.", "default": false }, "news": { "title": "News", "type": "boolean", "description": "Include public participant or competition news metadata where available. Default ON.", "default": true }, "liveRankings": { "title": "Live rankings", "type": "boolean", "description": "Include tennis live ranking projections from public ral_* feeds when available.", "default": false }, "articleContent": { "title": "Article content", "type": "boolean", "description": "Include the full body text on news_article records. Default ON. Set to false to keep only metadata (title, summary, public URL).", "default": true }, "raw": { "title": "Raw payloads", "type": "boolean", "description": "Include raw payloads for internal debugging only. Public dataset output removes raw payload fields.", "default": false } }, "default": { "commentary": false, "events": false, "highlights": false, "statistics": false, "lineups": false, "h2h": false, "momentum": false, "odds": false, "news": true, "liveRankings": false, "articleContent": true, "raw": false } }, "includeRaw": { "title": "Include raw payloads", "type": "boolean", "description": "Backward-compatible alias for include.raw. Raw payloads are disabled by default, only for internal debugging, and are removed from public dataset output.", "default": false }, "acknowledgeRawHighMemory": { "title": "Acknowledge raw + high-fan-out high-memory combination", "type": "boolean", "description": "Acknowledge that combining include.raw=true with oddsCoveragePreset=\"extended\"/\"global\"/\"max\" is high-memory. Intermediate records retain every HTTP response body until they are stripped at dataset push time, and these presets fan out odds requests across 20/28/48 geos respectively. The 2026-05-20 performance audit measured peak RAM near 1 GB on this combination, which can OOM-kill a standard 1-2 GB Actor tier. Leave this off (the default) and the parser will reject the high-RAM combination with a clear error. Set to true to opt in explicitly when you know what you are doing.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of dataset items to output across the whole run, not per locale/category. Bookmakers mode defaults to 1000 when omitted because the catalog contains more than 100 geo entries. For news article runs, use Maximum news items per task when each locale/category needs its own cap.", "default": 50 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Lower values are more polite and stable. Higher values may increase cost and failures.", "default": 2 }, "requestDelayMs": { "title": "Delay between requests in ms", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Politeness delay between requests/pages.", "default": 1000 }, "locale": { "title": "Locale", "type": "string", "description": "Language/locale preference for public pages where applicable.", "default": "en" }, "timezone": { "title": "Timezone", "type": "string", "description": "IANA timezone used for date feed requests, such as UTC, Europe/Lisbon or America/New_York. Output timestamps remain ISO UTC.", "default": "UTC" }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Estimate tasks and billing events without extracting paid detail data.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify proxy configuration. Do not use proxies to bypass access controls or evade restrictions." } } }, "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 } } } } } } } } } }