Flashscore
Live scores, match detail, competitions, standings, and sports news from Flashscore, served as plain REST.
Endpoints
| Endpoint | Query params | What it returns | Price | Data up to |
|---|---|---|---|---|
GET /flashscore/sports |
— | List of covered sports. | $0.001 | 5 min |
GET /flashscore/matches |
sport, date_offset |
Matches for a sport on a given day. | $0.003 | 30 sec |
GET /flashscore/matches/live |
sport |
Currently live matches for a sport. | $0.003 | 10 sec |
GET /flashscore/matches/detail |
event_id |
Full detail for one match. | $0.003 | 1 min |
GET /flashscore/matches/live-detail |
event_id |
Live summary feed for one match. | $0.003 | 10 sec |
GET /flashscore/matches/odds |
event_id, bookmaker_id, bet_type, bet_scope |
Betting odds for one match. | $0.003 | 1 min |
GET /flashscore/matches/lineups |
event_id |
Team lineups for one match. | $0.003 | 5 min |
GET /flashscore/matches/stats |
event_id |
Match statistics. | $0.003 | 1 min |
GET /flashscore/competitions |
— | List of competitions. | $0.001 | 15 min |
GET /flashscore/leagues |
sport |
Leagues for a sport. | $0.003 | 15 min |
GET /flashscore/competitions/seasons |
tournament_stage_id |
Season listing for a competition. | $0.003 | 15 min |
GET /flashscore/competitions/results |
tournament_stage_id, page |
Past results for a competition. | $0.003 | 5 min |
GET /flashscore/competitions/fixtures |
tournament_stage_id, page |
Upcoming fixtures for a competition. | $0.003 | 5 min |
GET /flashscore/competitions/standings |
tournament_id, tournament_stage_id, type |
League standings table. | $0.003 | 5 min |
GET /flashscore/competitions/topscorers |
tournament_id, tournament_stage_id |
Top scorers for a competition. | $0.003 | 15 min |
GET /flashscore/competitions/draw |
tournament_id, tournament_stage_id |
Competition draw/bracket. | $0.003 | 15 min |
GET /flashscore/search/top |
lang |
Top/trending search suggestions. | $0.001 | 5 min |
GET /flashscore/news |
tag_id |
News articles, optionally filtered by tag. | $0.003 | 1 min |
GET /flashscore/news/menu |
— | News category/tag menu. | $0.001 | 15 min |
GET /flashscore/news/article |
article_id |
Full content of one news article. | $0.003 | 5 min |
GET /flashscore/search |
q, lang |
Search teams, players, and competitions. | $0.003 | 1 min |
Prices are per call, paid in USDC with x402. "Data up to" is the cache window: a repeated call inside it returns the same data.
Calling it
# x402: no account or API key. The server answers 402 with payment instructions; an x402 client pays and repeats the request.
curl -i "https://<base-url>/flashscore/matches?sport=soccer"
Responses are JSON, each wrapped as {"result": ...} (except matches/live-detail, which returns {"versionHash", "summary"}).
Notes
sportaccepts either a known sport name or any numeric sport id — Flashscore's own client only validates names, not numeric ids.standings.type(OVERALL, HOME, AWAY, FORM) is a closed enum.matches.date_offsetis limited to -7..7; values outside that range return no data.bet_type/bet_scopeonmatches/oddsare free text.