Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Flashscore API page →
Media, Film & Knowledge

Flashscore API & Scraper

This API reads Flashscore as JSON, logged out, the way a visitor of flashscore.com sees it.

52 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

`matches` returns every match of one sport on one day (today and 7 days either side), grouped by competition, with the status, the minute or set in play, the score, the score of each half, quarter, period or set, both sides with their ids and logos, and the competition ids; golf, motorsport, cycling and horse racing come back as leaderboards. A match id opens 17 match tabs: the event timeline (goals with scorer and assist, cards with the reason, substitutions with the player in and out), team statistics for the match and each half (about 40 per period in football: expected goals, possession, shots, passes, duels …), lineups with formation, shirt numbers and player ratings, predicted lineups, missing players, about 90 statistics per player, head-to-head, odds of every bookmaker shown for a country, minute-by-minute text commentary, tennis point-by-point, the competition table, top scorers, TV channels, video highlights and the momentum graph. For a competition it returns the standings (overall, home, away, form, over/under, half-time/full-time), results and fixtures page by page, top scorers, the knockout draw and every past season with its champion. Team calls return the squad with appearances, minutes, goals and cards, results going back many seasons, fixtures and transfers with fees; player calls return the profile, market value, contract end, career by season, transfers, injuries and last matches.

Reference

What a Flashscore field actually contains

Fields that read differently from how they look. Every row was measured against live Flashscore on 2026-11-16.

FieldWhat it holds
home_score, away_scoreGoals or points scored in play, overtime and extra time included, as the match page shows them (a football cup tie won 3-2 on penalties after 1-0: 1 and 0). The shoot-out is in home_penalties and away_penalties.
home_score_incl_shootoutThe result as Flashscore records it, with one goal added for the shoot-out winner (the same tie: 2 and 0). Shown because Flashscore's own head-to-head lists print this figure ("3:2" for a 2-2 draw won on penalties).
home_score_regular_timeThe score after regular time. Differs from home_score after overtime: a basketball game that went to overtime reads 98-98 here and 104-110 in home_score.
periods on a football rowFootball day lists carry the score of the 2nd half only, named "2nd Half" (the match page shows "1st Half 1 - 2", "2nd Half 0 - 0"). The score of both halves is in match_summary.
start_time / start_time_localstart_time is UTC. start_time_local is the same moment in the timezone you pass; the timezone also decides which matches belong to the requested day.
stageThe site's own stage label: Finished, After Penalties, 2nd Half, Set 3, 3rd Quarter, Postponed and so on.
assists in top scorersTaken from the column the players' own career rows confirm (Mbappe, LaLiga 2026/27: 13 goals, 2 assists in both places).
codesValues Flashscore sends whose meaning could not be proven (for example two counters on football rows). They are returned unchanged rather than dropped.

Data is what Flashscore shows to a visitor who is not logged in. Bookmakers and odds depend on the country you pass in geo, as they do on the website.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/flashscore/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "arsenal"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "flashscore",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 516,
    "record_count": 20,
    "bytes": 14243,
    "cache_hit": false,
    "upstream_requests": 1,
    "charged_credits": 1,
    "version": "0.1.0",
    "request_id": "0d58dc217049491f",
    "queue_ms": 2.2,
    "fetched_at": "2026-11-16T21:05:22.588Z"
  },
  "data": {
    "query": "arsenal",
    "type": "all",
    "count": 20,
    "results": [
      {
        "id": "hA1Zm19f",
        "type": "team",
        "type_name": "Team",
        "name": "Arsenal",
        "slug": "arsenal",
        "sport": {
          "id": 1,
          "name": "Football",
          "slug": "football"
        },
        "country": {
          "id": 198,
          "name": "England"
        },
        "gender": "Men",
        "image": "https://static.flashscore.com/res/image/data/0n1ffK6k-vcNAdtF9.png",
        "link": "https://www.flashscore.com/team/arsenal/hA1Zm19f/"
      },
      {
        "id": "8CKOoQdn",
        "type": "team",
        "type_name": "Team",
        "name": "Arsenal W",
        "slug": "arsenal",
        "sport": {
          "id": 1,
          "name": "Football",
          "slug": "football"
        },
        "country": {
          "id": 198,
          "name": "England"
        },
        "gender": "Women",
        "image": "https://static.flashscore.com/res/image/data/8QWmNJR0-QmAvFdvS.png",
        "link": "https://www.flashscore.com/team/arsenal/8CKOoQdn/"
      },
      {
        "id": "hfGlpT1g",
        "type": "team",
        "type_name": "Team",
        "name": "Arsenal U19",
        "slug": "arsenal",
        "sport": {
          "id": 1,
          "name": "Football",
          "slug": "football"
        },
        "country": {
          "id": 198,
          "name": "England"
        },
        "gender": "Men",
        "image": "https://static.flashscore.com/res/image/data/nTA3yg96-0KPo4rhR.png",
        "link": "https://www.flashscore.com/team/arsenal/hfGlpT1g/"
      }
    ]
  }
}
Actions

What the Flashscore API does

ActionDescriptionConcrete use caseKey params
sportsEvery sport Flashscore has a page for (34) with today's event count and how many are live right now.Content platforms call sports to get every sport Flashscore has a page for (34) with today's event count and how many are live rig….none
countriesThe country / category menu of one sport (for tennis: ATP Singles, WTA Doubles … categories).Research tools call countries to get the country / category menu of one sport (for tennis.sport
tournamentsEvery competition of one country in one sport, in the site's own menu order, with the link the tournament_* actions take.Community analysts call tournaments to get every competition of one country in one sport, in the site's own menu order, with the link th….country, sport
searchSearch teams, players and competitions by name (Flashscore's own search box; it returns up to 20 hits). Rows carry the id and link every other action takes.Media monitors call search to search teams, players and competitions by name (Flashscore's own search box; it.query, type, sport
resolveTurn any flashscore.com link into the ids this API takes (match, team, player, competition with its tournament/stage/template/season ids).Content platforms call resolve to turn any flashscore.com link into the ids this API takes (match, team, player, competition wi….url
matchesAll matches of one sport on one day (today ±7 days), grouped by competition, with scores, period scores, stage and both sides. Golf, motorsport, cycling, horse racing and winter sports return a `leaderboard` per event instead.Research tools call matches to get all matches of one sport on one day (today ±7 days), grouped by competition, with scores, per….sport, date, day, timezone, status
live_matchesMatches of one sport in play right now, grouped by competition.Community analysts call live_matches to get matches of one sport in play right now, grouped by competition..sport, timezone
live_updatesThe small change feed the site polls every few seconds: only the matches whose score, stage or serve just changed.Media monitors call live_updates to get the small change feed the site polls every few seconds.sport
matchOne match: both sides (ids, names, logos, ranking), competition and round, status, scores incl. penalties, the tabs the match has, venue, referee, capacity and attendance.Content platforms call match to get one match.match, timezone
match_summaryTimeline of events: goals (scorer, assist), cards with reason, substitutions (in and out), VAR, with the running score per period.Research tools call match_summary to get timeline of events.match, timezone
match_statisticsTeam statistics (xG, possession, shots, passes, duels … as the site publishes per sport) for the match and each half/period.Community analysts call match_statistics to get team statistics (xG, possession, shots, passes, duels … as the site publishes per sport) for….match, timezone, period
match_lineupsLineups: formation, starters, substitutes, coaches, shirt numbers, player ratings, captain/goalkeeper roles, substitutions with minutes.Media monitors call match_lineups to get lineups.match, timezone
match_predicted_lineupsPredicted lineups the site shows before kick-off.Content platforms call match_predicted_lineups to get predicted lineups the site shows before kick-off..match, timezone
match_missing_playersInjured, suspended and doubtful players of both sides with the reason.Research tools call match_missing_players to get injured, suspended and doubtful players of both sides with the reason..match, timezone
match_player_statisticsPer-player match statistics (about 90 types for football: rating, minutes, xG, passes, duels …).Community analysts call match_player_statistics to get per-player match statistics (about 90 types for football.match, timezone
match_h2hHead-to-head: each side's last matches and the previous meetings, per tab (overall / home / away; surfaces for tennis).Media monitors call match_h2h to get head-to-head.match, timezone
match_oddsBookmaker odds comparison for the match (1X2, over/under, Asian handicap, both teams to score …), opening and current odds. Bookmakers depend on `geo`.Content platforms call match_odds to get bookmaker odds comparison for the match (1X2, over/under, Asian handicap, both teams to score….match, timezone, geo, bet_type, bet_scope
match_commentaryLive text commentary, minute by minute.Research tools call match_commentary to get live text commentary, minute by minute..match, timezone
match_point_by_pointTennis / table tennis point-by-point: every game of every set with server, breaks and the point sequence.Community analysts call match_point_by_point to get tennis / table tennis point-by-point.match, timezone
match_standingsThe competition table as the match page shows it.Media monitors call match_standings to get the competition table as the match page shows it..match, timezone, type, line
match_top_scorersThe competition's top scorers, from the match page.Content platforms call match_top_scorers to get the competition's top scorers, from the match page..match, timezone
match_reportMatch report / preview article published on the match page.Research tools call match_report to match report / preview article published on the match page..match, timezone
match_newsNews on the match page: headlines and the Flashscore article ids about both sides.Community analysts call match_news to get news on the match page.match, timezone
match_broadcastsTV channels by country and streaming providers.Media monitors call match_broadcasts to get tV channels by country and streaming providers..match, timezone
match_highlightsVideo highlights linked on the match page.Content platforms call match_highlights to get video highlights linked on the match page..match, timezone
match_momentumMatch momentum graph values, minute by minute (football).Research tools call match_momentum to match momentum graph values, minute by minute (football)..match, timezone
tournamentOne competition: name, country, current season, stages with dates, winners, ids.Community analysts call tournament to get one competition.tournament, season
tournament_seasonsEvery season of a competition with its id pair, link and winner (the archive).Media monitors call tournament_seasons to get every season of a competition with its id pair, link and winner (the archive)..tournament
tournament_standingsStandings: overall, home, away, form, over/under, half-time/full-time, with zones and form strip.Content platforms call tournament_standings to get standings.tournament, type, line, season
tournament_standings_typesWhich standings tables a competition publishes.Research tools call tournament_standings_types to get which standings tables a competition publishes..tournament, season
tournament_resultsFinished matches of a competition season, newest first, about 100 per page.Community analysts call tournament_results to get finished matches of a competition season, newest first, about 100 per page..tournament, page, timezone
tournament_fixturesUpcoming matches of a competition season, about 100-120 per page.Media monitors call tournament_fixtures to get upcoming matches of a competition season, about 100-120 per page..tournament, page, timezone
tournament_top_scorersTop scorers of a competition season.Content platforms call tournament_top_scorers to get top scorers of a competition season..tournament, season
tournament_drawKnockout bracket (cups, tennis tournaments): every tie by round with seeds, score and winner.Research tools call tournament_draw to get knockout bracket (cups, tennis tournaments).tournament, season
teamTeam profile: name, sport, country, logo, stadium and capacity, current competition and its seasons, competitions won.Community analysts call team to get team profile.team, sport
team_squadSquad by position with shirt number, age, appearances, minutes, goals, assists and cards — per competition filter the site shows.Media monitors call team_squad to get squad by position with shirt number, age, appearances, minutes, goals, assists and cards.team, competition, sport
team_resultsA team's finished matches, newest first, 40 per page, going back many seasons.Content platforms call team_results to get a team's finished matches, newest first, 40 per page, going back many seasons..team, page, sport, timezone
team_fixturesA team's upcoming matches.Research tools call team_fixtures to get a team's upcoming matches..team, page, sport, timezone
team_transfersArrivals and departures: date, player, both clubs, type (loan, transfer, free) and fee; 15 per page.Community analysts call team_transfers to get arrivals and departures.team, direction, page, sport
team_standingsThe table of the league the team plays in now.Media monitors call team_standings to get the table of the league the team plays in now..team, type, line, sport
team_top_scorersTop scorers of the league the team plays in now.Content platforms call team_top_scorers to get top scorers of the league the team plays in now..team, sport
team_newsHeadlines about the team.Research tools call team_news to get headlines about the team..team
playerPlayer profile with everything the page shows: position, club, age, birth date, market value, contract end, career by season and competition, transfers, injury history and last matches with rating.Community analysts call player to get player profile with everything the page shows.player
player_careerCareer tables (league, domestic cups, international cups, national team): season, team, competition, rating, apps, goals, assists, cards.Media monitors call player_career to get career tables (league, domestic cups, international cups, national team).player
player_transfersTransfer history of a player.Content platforms call player_transfers to get transfer history of a player..player
player_injuriesInjury history of a player.Research tools call player_injuries to get injury history of a player..player
player_last_matchesA player's last matches with rating and minutes.Community analysts call player_last_matches to get a player's last matches with rating and minutes..player
player_newsHeadlines about the player.Media monitors call player_news to get headlines about the player..player
rankingsRanking tables a sport publishes (tennis ATP/WTA singles, doubles and race; football FIFA/UEFA …).Content platforms call rankings to get ranking tables a sport publishes (tennis ATP/WTA singles, doubles and race; football FIFA/UEF….sport
rankingOne ranking table: rank, previous rank, player/team, country, points, tournaments played. Page 1 = top 100, page 2 = the rest.Research tools call ranking to get one ranking table.ranking, page
newsA sport's news front page, in the site's sections.Community analysts call news to get a sport's news front page, in the site's sections..sport
news_articleOne Flashscore news article in full.Media monitors call news_article to get one Flashscore news article in full..article
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/flashscore/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"arsenal"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.flashscore.search with {"query":"arsenal"}.
Use cases

Who uses this API and why

  • Live score widgets: Poll matches or live_matches for a sport and show scores, minute, set or quarter as they change; live_updates returns only what changed.
  • Betting and odds research: Combine match_odds (current and opening odds per bookmaker and country) with match_h2h, form tables and team statistics.
  • Fantasy and scouting: Use match_player_statistics, lineups with ratings, squads with minutes and goals, and player careers to rank players.
  • Sports data products: Build fixture, result and standings feeds for any league, with every past season and its champion.
  • Tennis analytics: Point-by-point sequences, set scores with tiebreaks, ATP and WTA rankings, titles and season match records per player.
FAQ

Questions developers ask before integrating

Do I need a Flashscore account?

No. Everything is read from the public Flashscore website without logging in; you only need a ReefAPI key.

Which sports are covered?

The 34 sports Flashscore has pages for, including football, tennis, basketball, ice hockey, American football, baseball, handball, volleyball, cricket, rugby union and league, darts, snooker, MMA, boxing, golf, motorsport, cycling and eSports. The sports action lists them with today's match count and how many are live.

How far back and ahead does the daily list go?

Seven days either side of today, in the timezone you pass. Older matches come from tournament_results or team_results, which page back through past seasons (Arsenal's results reach at least 30 pages of 40 matches).

Are the scores the same as on flashscore.com?

Yes. On 2026-11-16 the score, the period scores and the events of 17 matches in football, tennis, basketball, ice hockey and cricket, 8 of them live, were compared with the rendered match page in the same minute (25 of 25 scores and 49 of 49 events equal), and 202 standings rows in 6 leagues across football, basketball and ice hockey were compared row by row (202 of 202 equal). For an ice hockey game decided by a shoot-out the page headline shows the shoot-out winner one goal up; that figure is home_score_incl_shootout.

Can I get odds?

Yes. match_odds returns every bookmaker Flashscore lists for the country in geo, with current and opening odds per market (1X2, over/under, Asian handicap, both teams to score, correct score and more). Measured on one match: 3 bookmakers for US, 7 for DE, 20 for GB.

Do I get player ratings and player statistics?

Where Flashscore publishes them. match_lineups carries each player's rating; match_player_statistics returns about 90 statistics per player for football matches that have the tab. The available_tabs field of every match call says which tabs a match has.

How do I find a team, player or competition id?

Use search with a name (up to 20 results per query, at least 2 characters), or pass any flashscore.com link: every action takes the link as well as the id, and resolve turns a link into ids.

Is there a limit on results per call?

Lists follow Flashscore's own pages: about 100 to 120 matches per page of competition results or fixtures, 40 per page of team results, 15 transfers per page, the top 100 of a ranking on page 1 and the rest on page 2.

What is the Flashscore API?

Flashscore API is a ReefAPI endpoint group for live scores, results and fixtures for 34 sports, with match statistics, lineups, odds, standings, teams, players and rankings. It returns live JSON through POST requests under /flashscore/v1.

Is the Flashscore API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Flashscore calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Flashscore login or account?

No login to Flashscore is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Flashscore data?

The page example is captured from a live sports call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Flashscore API use?

Flashscore actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Flashscore from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call flashscore actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / flashscore

Flashscore

Live scores, results and fixtures for 34 sports, with match statistics, lineups, odds, standings, teams, players and rankings.

base /flashscore/v152 endpoints
post/flashscore/v1/sports1 credit

Every sport Flashscore has a page for (34) with today's event count and how many are live right now.

Try in playground →
post/flashscore/v1/countries1 credit

The country / category menu of one sport (for tennis: ATP Singles, WTA Doubles … categories).

ParameterAllowed / rangeDescription
sport = footballoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiSport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too.
Try in playground →
post/flashscore/v1/tournaments1 credit

Every competition of one country in one sport, in the site's own menu order, with the link the tournament_* actions take.

ParameterAllowed / rangeDescription
sport = footballoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiSport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too.
countryrequired—Country name, slug or id from `countries`.
Try in playground →
post/flashscore/v1/resolve1 credit

Turn any flashscore.com link into the ids this API takes (match, team, player, competition with its tournament/stage/template/season ids).

ParameterAllowed / rangeDescription
urlrequired—A flashscore.com link.
Try in playground →
post/flashscore/v1/matches1 credit

All matches of one sport on one day (today ±7 days), grouped by competition, with scores, period scores, stage and both sides. Golf, motorsport, cycling, horse racing and winter sports return a `leaderboard` per event instead.

ParameterAllowed / rangeDescription
sport = footballoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiSport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too.
dateoptional—YYYY-MM-DD within today ±7 days (in `timezone`).
day = 0optional-7–7Day offset from today, -7…7 (used when `date` is not given).
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
status = alloptionalall · scheduled · live · finishedKeep only these.
Try in playground →
post/flashscore/v1/live_matches1 credit

Matches of one sport in play right now, grouped by competition.

ParameterAllowed / rangeDescription
sport = footballoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiSport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/live_updates2 credits

The small change feed the site polls every few seconds: only the matches whose score, stage or serve just changed.

ParameterAllowed / rangeDescription
sport = footballoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiSport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too.
Try in playground →
post/flashscore/v1/match2 credits

One match: both sides (ids, names, logos, ranking), competition and round, status, scores incl. penalties, the tabs the match has, venue, referee, capacity and attendance.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_summary2 credits

Timeline of events: goals (scorer, assist), cards with reason, substitutions (in and out), VAR, with the running score per period.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_statistics2 credits

Team statistics (xG, possession, shots, passes, duels … as the site publishes per sport) for the match and each half/period.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
periodoptional—Only this period (Match, 1st Half, 2nd Half …).
Try in playground →
post/flashscore/v1/match_lineups2 credits

Lineups: formation, starters, substitutes, coaches, shirt numbers, player ratings, captain/goalkeeper roles, substitutions with minutes.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_predicted_lineups2 credits

Predicted lineups the site shows before kick-off.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_missing_players2 credits

Injured, suspended and doubtful players of both sides with the reason.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_player_statistics3 credits

Per-player match statistics (about 90 types for football: rating, minutes, xG, passes, duels …).

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_h2h2 credits

Head-to-head: each side's last matches and the previous meetings, per tab (overall / home / away; surfaces for tennis).

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_odds2 credits

Bookmaker odds comparison for the match (1X2, over/under, Asian handicap, both teams to score …), opening and current odds. Bookmakers depend on `geo`.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
geo = USoptional—2-letter country code whose bookmakers to show (US, GB, DE, IN …).
bet_typeoptional—Only one market type.
bet_scopeoptional—FULL_TIME, FIRST_HALF or SECOND_HALF.
Try in playground →
post/flashscore/v1/match_commentary2 credits

Live text commentary, minute by minute.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_point_by_point2 credits

Tennis / table tennis point-by-point: every game of every set with server, breaks and the point sequence.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_standings2 credits

The competition table as the match page shows it.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
type = overalloptionaloverall · home · away · form · form_home · form_away · over_under · over_under_home · over_under_away · ht_ft · ht_ft_home · ht_ft_awayWhich table: league table, home/away split, form, over/under, half-time/full-time.
line = alloptional—Over/under goal line (over_under tables only): `all` or a line such as 2.5; the answer's `lines` lists the ones the competition publishes.
Try in playground →
post/flashscore/v1/match_top_scorers2 credits

The competition's top scorers, from the match page.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_report2 credits

Match report / preview article published on the match page.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_news2 credits

News on the match page: headlines and the Flashscore article ids about both sides.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_broadcasts2 credits

TV channels by country and streaming providers.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_highlights2 credits

Video highlights linked on the match page.

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/match_momentum2 credits

Match momentum graph values, minute by minute (football).

ParameterAllowed / rangeDescription
matchrequired—Flashscore match id (8 characters, as every list in this API returns it) or a flashscore.com match link.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/tournament3 credits

One competition: name, country, current season, stages with dates, winners, ids.

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
seasonoptional—Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).
Try in playground →
post/flashscore/v1/tournament_seasons3 credits

Every season of a competition with its id pair, link and winner (the archive).

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
Try in playground →
post/flashscore/v1/tournament_standings1 credit

Standings: overall, home, away, form, over/under, half-time/full-time, with zones and form strip.

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
type = overalloptionaloverall · home · away · form · form_home · form_away · over_under · over_under_home · over_under_away · ht_ft · ht_ft_home · ht_ft_awayWhich table: league table, home/away split, form, over/under, half-time/full-time.
line = alloptional—Over/under goal line (over_under tables only): `all` or a line such as 2.5; the answer's `lines` lists the ones the competition publishes.
seasonoptional—Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).
Try in playground →
post/flashscore/v1/tournament_standings_types2 credits

Which standings tables a competition publishes.

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
seasonoptional—Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).
Try in playground →
post/flashscore/v1/tournament_results1 credit

Finished matches of a competition season, newest first, about 100 per page.

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
page = 1optional1–Page number, 1-based.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/tournament_fixtures1 credit

Upcoming matches of a competition season, about 100-120 per page.

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
page = 1optional1–Page number, 1-based.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/tournament_top_scorers1 credit

Top scorers of a competition season.

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
seasonoptional—Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).
Try in playground →
post/flashscore/v1/tournament_draw2 credits

Knockout bracket (cups, tennis tournaments): every tie by round with seeds, score and winner.

ParameterAllowed / rangeDescription
tournamentrequired—Competition link or path (/football/england/premier-league/, a past season /football/england/premier-league-2024-2025/) or a '<tournament_id>:<stage_id>' pair from `search` / `tournament_seasons`.
seasonoptional—Pick another season of the competition by its label (2024/2025, 2024-2025, 2025).
Try in playground →
post/flashscore/v1/team2 credits

Team profile: name, sport, country, logo, stadium and capacity, current competition and its seasons, competitions won.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
sportoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiThe team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works.
Try in playground →
post/flashscore/v1/team_squad2 credits

Squad by position with shirt number, age, appearances, minutes, goals, assists and cards — per competition filter the site shows.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
competitionoptional—Only this competition's table (Total = all).
sportoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiThe team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works.
Try in playground →
post/flashscore/v1/team_results2 credits

A team's finished matches, newest first, 40 per page, going back many seasons.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
page = 1optional1–Page number, 1-based.
sportoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiThe team's sport; saves one page lookup.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/team_fixtures1 credit

A team's upcoming matches.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
page = 1optional1–Page number, 1-based.
sportoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiThe team's sport; saves one page lookup.
timezone = UTCoptional—IANA timezone or UTC offset (+3, -5, +05:30). Decides where the day starts and ends (the site sends whole-hour offsets) and fills every `start_time_local`. `start_time` is always UTC.
Try in playground →
post/flashscore/v1/team_transfers1 credit

Arrivals and departures: date, player, both clubs, type (loan, transfer, free) and fee; 15 per page.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
direction = alloptionalall · in · out—
page = 1optional1–Page number, 1-based.
sportoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiThe team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works.
Try in playground →
post/flashscore/v1/team_standings1 credit

The table of the league the team plays in now.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
type = overalloptionaloverall · home · away · form · form_home · form_away · over_under · over_under_home · over_under_away · ht_ft · ht_ft_home · ht_ft_awayWhich table: league table, home/away split, form, over/under, half-time/full-time.
line = alloptional—Over/under goal line (over_under tables only): `all` or a line such as 2.5; the answer's `lines` lists the ones the competition publishes.
sportoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiThe team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works.
Try in playground →
post/flashscore/v1/team_top_scorers1 credit

Top scorers of the league the team plays in now.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
sportoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiThe team's sport (optional). Needed only for a bare id of a team that has no transfer feed (national teams, most non-football clubs); the team link always works.
Try in playground →
post/flashscore/v1/team_news1 credit

Headlines about the team.

ParameterAllowed / rangeDescription
teamrequired—Flashscore team id (8 characters, from `search` or any match row) or a flashscore.com/team/<name>/<id>/ link.
Try in playground →
post/flashscore/v1/player2 credits

Player profile with everything the page shows: position, club, age, birth date, market value, contract end, career by season and competition, transfers, injury history and last matches with rating.

ParameterAllowed / rangeDescription
playerrequired—Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.
Try in playground →
post/flashscore/v1/player_career2 credits

Career tables (league, domestic cups, international cups, national team): season, team, competition, rating, apps, goals, assists, cards.

ParameterAllowed / rangeDescription
playerrequired—Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.
Try in playground →
post/flashscore/v1/player_transfers2 credits

Transfer history of a player.

ParameterAllowed / rangeDescription
playerrequired—Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.
Try in playground →
post/flashscore/v1/player_injuries2 credits

Injury history of a player.

ParameterAllowed / rangeDescription
playerrequired—Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.
Try in playground →
post/flashscore/v1/player_last_matches2 credits

A player's last matches with rating and minutes.

ParameterAllowed / rangeDescription
playerrequired—Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.
Try in playground →
post/flashscore/v1/player_news1 credit

Headlines about the player.

ParameterAllowed / rangeDescription
playerrequired—Flashscore player id (8 characters, from `search`, lineups or squads) or a flashscore.com/player/<name>/<id>/ link.
Try in playground →
post/flashscore/v1/rankings1 credit

Ranking tables a sport publishes (tennis ATP/WTA singles, doubles and race; football FIFA/UEFA …).

ParameterAllowed / rangeDescription
sport = tennisoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiSport slug.
Try in playground →
post/flashscore/v1/ranking1 credit

One ranking table: rank, previous rank, player/team, country, points, tournaments played. Page 1 = top 100, page 2 = the rest.

ParameterAllowed / rangeDescription
rankingrequired—Ranking link from `rankings`, or its 8-character id.
page = 1optional1–21 = top 100, 2 = everyone after that.
Try in playground →
post/flashscore/v1/news1 credit

A sport's news front page, in the site's sections.

ParameterAllowed / rangeDescription
sport = footballoptionalfootball · tennis · basketball · hockey · american-football · baseball · handball · rugby-union · 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 · cycling · horse-racing · esports · winter-sports · kabaddiSport slug. Numeric Flashscore ids, names and common aliases (soccer, nba, nhl, nfl, ufc, f1) are accepted too.
Try in playground →
post/flashscore/v1/news_article1 credit

One Flashscore news article in full.

ParameterAllowed / rangeDescription
articlerequired—Article id or flashscore.com/news link.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.