This is an API for the World Cup(2014,2018) and Women's World Cup(2015,2019) that scrapes current match results and outputs match data as JSON. No guarantees are made as to its accuracy, but we will do our best to keep it up to date. For example responses, including events such as goals, substitutions, and cards, see the GitHub page.
(2018 Men's World Cup data has been archived here if you are still using that data:
https://world-cup-json-2018.herokuapp.com/matches
)
All match data, updated every minute
(note - truncated data in this view of all matches, pass `?details=true` to get all matches with all events)
https://worldcup.sfg.io/matches
Today's matches
https://worldcup.sfg.io/matches/today
Returns the current match, if a match is happening, otherwise nothing
https://worldcup.sfg.io/matches/current
Matches for any country, by entering their FIFA Code.
https://worldcup.sfg.io/matches/country?fifa_code=ARG
Results for teams (wins, losses, draws, goals_for, goals_against)
https://worldcup.sfg.io/teams/results
Results for teams by group, ordered by current group position
https://worldcup.sfg.io/teams/group_results
List of all teams in world cup, along with FIFA abbreviation
https://worldcup.sfg.io/teams/
You can append ?by_date=desc
to any query to sort the matches by future to past. ?by_date=asc
does past to future.
https://worldcup.sfg.io/matches/today/?by_date=DESC
You can append ?by=
with optional params total_goals
, closest_score
, away_team_goals
, home_team_goals
https://worldcup.sfg.io/matches/?by=total_goals