Ball

Women's World Cup

...in JSON

This is an API for the World Cup (and now, Women's World Cup!) 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.

ENDPOINTS

All match data, updated every minute
http://worldcup.sfg.io/matches

Today's matches
http://worldcup.sfg.io/matches/today

Returns the current match, if a match is happening, otherwise nothing
http://worldcup.sfg.io/matches/current

Matches for any country, by entering their FIFA Code.
http://worldcup.sfg.io/matches/country?fifa_code=USA

Results for teams (wins, losses, draws, goals_for, goals_against)
http://worldcup.sfg.io/teams/results

Results for teams by group, ordered by curren group position
http://worldcup.sfg.io/teams/group_results

List of all teams in world cup, along with fifa abbreviation
http://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. http://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 http://worldcup.sfg.io/matches/?by=total_goals

TODAY'S MATCHES

TOMORROW'S MATCHES