Flashscore Sports Data API — 58 record types, 40 sports
Pricing
Pay per event
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.
Choose what type of data to extract. Bookmakers mode is betting-adjacent, must be used only where permitted, and is not an odds feed.
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.
[ "football"]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.
[]Optional Flashscore match IDs if known.
[]Search terms for mode search. Each query must be at least 2 characters. Use topSearch for popular suggestions without a query.
[]Maximum search results requested per query or top-search task. Flashscore currently supports useful limits up to 50.
Optional post-filter for search results. Leave empty to return teams, players and competitions.
[]In news article mode, collect broad locale coverage while deduplicating equivalent sources internally. In newsCategories mode, fetch every known public news menu.
Advanced selector for exact public Flashscore News project ids. Prefer newsLocales for normal use; use mode newsLocales to discover supported locale/project combinations.
[]Exact Flashscore news locales to use, such as pt, pt-br, en-uk or es-mx. Use mode newsLocales to list available values.
[]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.
[]In countries mode, fetch leagues and tournaments inside each discovered country/category.
Maximum concurrent competition requests inside each countries task.
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.
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.
Optional subdivision code (ISO 3166-2 style) used by Flashscore winner odds requests.
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.
Legacy match-odds subdivision code (ISO 3166-2 style). Used with oddsGeoIpCode when deriving legacy coverage targets.
Legacy match-odds project fan-out. Leave empty to use oddsCoveragePreset or oddsCoverageTargets. If supplied, each project id is requested with oddsGeoIpCode and oddsGeoIpSubdivisionCode.
[]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.
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.
[ { "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": "" }]Optional per-locale/category cap for news article collection. The global Maximum results cap still applies to the whole run.
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.
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.
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.
{ "commentary": false, "events": false, "highlights": false, "statistics": false, "lineups": false, "h2h": false, "momentum": false, "odds": false, "news": true, "liveRankings": false, "articleContent": true, "raw": false}Backward-compatible alias for include.raw. Raw payloads are disabled by default, only for internal debugging, and are removed from public dataset output.
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.
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.
Lower values are more polite and stable. Higher values may increase cost and failures.
Politeness delay between requests/pages.
Language/locale preference for public pages where applicable.
IANA timezone used for date feed requests, such as UTC, Europe/Lisbon or America/New_York. Output timestamps remain ISO UTC.
Estimate tasks and billing events without extracting paid detail data.