Flashscore API & Scraper
This API reads Flashscore as JSON, logged out, the way a visitor of flashscore.com sees it.
🤖 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.
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.
| Field | What it holds |
|---|---|
| home_score, away_score | Goals 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_shootout | The 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_time | The 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 row | Football 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_local | start_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. |
| stage | The site's own stage label: Finished, After Penalties, 2nd Half, Set 3, 3rd Quarter, Postponed and so on. |
| assists in top scorers | Taken from the column the players' own career rows confirm (Mbappe, LaLiga 2026/27: 13 goals, 2 assists in both places). |
| codes | Values 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.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/flashscore/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "arsenal"
}
}{
"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/"
}
]
}
}What the Flashscore API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| sports | Every 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 |
| countries | The 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 |
| tournaments | Every 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 |
| search | Search 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 |
| resolve | Turn 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 |
| matches | 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. | 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_matches | Matches 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_updates | The 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 |
| match | 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. | Content platforms call match to get one match. | match, timezone |
| match_summary | Timeline 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_statistics | Team 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_lineups | Lineups: 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_lineups | Predicted 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_players | Injured, 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_statistics | Per-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_h2h | Head-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_odds | Bookmaker 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_commentary | Live text commentary, minute by minute. | Research tools call match_commentary to get live text commentary, minute by minute.. | match, timezone |
| match_point_by_point | Tennis / 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_standings | The 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_scorers | The 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_report | Match 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_news | News 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_broadcasts | TV channels by country and streaming providers. | Media monitors call match_broadcasts to get tV channels by country and streaming providers.. | match, timezone |
| match_highlights | Video highlights linked on the match page. | Content platforms call match_highlights to get video highlights linked on the match page.. | match, timezone |
| match_momentum | Match momentum graph values, minute by minute (football). | Research tools call match_momentum to match momentum graph values, minute by minute (football).. | match, timezone |
| tournament | One competition: name, country, current season, stages with dates, winners, ids. | Community analysts call tournament to get one competition. | tournament, season |
| tournament_seasons | Every 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_standings | Standings: 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_types | Which standings tables a competition publishes. | Research tools call tournament_standings_types to get which standings tables a competition publishes.. | tournament, season |
| tournament_results | Finished 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_fixtures | Upcoming 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_scorers | Top scorers of a competition season. | Content platforms call tournament_top_scorers to get top scorers of a competition season.. | tournament, season |
| tournament_draw | Knockout 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 |
| team | Team 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_squad | Squad 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_results | A 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_fixtures | A team's upcoming matches. | Research tools call team_fixtures to get a team's upcoming matches.. | team, page, sport, timezone |
| team_transfers | Arrivals 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_standings | The 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_scorers | Top 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_news | Headlines about the team. | Research tools call team_news to get headlines about the team.. | team |
| player | 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. | Community analysts call player to get player profile with everything the page shows. | player |
| player_career | Career 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_transfers | Transfer history of a player. | Content platforms call player_transfers to get transfer history of a player.. | player |
| player_injuries | Injury history of a player. | Research tools call player_injuries to get injury history of a player.. | player |
| player_last_matches | A 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_news | Headlines about the player. | Media monitors call player_news to get headlines about the player.. | player |
| rankings | Ranking 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 |
| ranking | One 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 |
| news | A 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_article | One Flashscore news article in full. | Media monitors call news_article to get one Flashscore news article in full.. | article |
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"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/flashscore/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "arsenal"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/flashscore/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "arsenal"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.flashscore.search with {"query":"arsenal"}.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.
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.