Ball

Womens World Cup 2019

...in JSON

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 )

ENDPOINTS

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/

OPTIONAL PARAMETERS

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

YESTERDAY'S MATCHES

TODAY'S MATCHES

TOMORROW'S MATCHES