AI Image


API Documentation

Agones is a distinct online platform providing an in-depth retrospect of soccer match outcomes spanning over the past 15 years (going back to 2007), and continuing up to the minute with live games, as well as offering a glimpse into the future through outlining the schedule for the next 10 days. Universally used and revered, Agones encapsulates results from a comprehensive range of countries and leagues globally. The service allows you to retrieve data in a user-friendly format, by presenting an array of information including teams, half-time and current scores, as well as the match's state in a single-line string. Additionally, users can request specific data by entering one or two teams, thereby defining the matches returned. The date_type parameter allows one to narrow down results even further, retrieving the most recent gameplay with 'latest', the upcoming match with 'next', or a range of games with 'range', the latter utilizing the 'from' and 'until' date parameters. If a match is live when requested, Agones astounds by revealing the current minute, ensuring you're always up to date with the global soccer stage. As its namesake in ancient Greece, Agones proves to be a champion for the modern lovers of football.




Example Prompts


What was the latest match result for team Barcelona?


When is the next match between Real Madrid and Liverpool?


Show me the soccer match results for Manchester United from


Can you find the latest game result for team Juventus?


What are the upcoming matches for teams Paris Saint-Germain and Bayern Munich?


Get me the match results for Arsenal within the date range of


When is the next scheduled game for Chelsea and Manchester City?


I'd like to know the most recent game outcome for team AC Milan.


Can you tell me the next match date for Borussia Dortmund and Atletico Madrid?


Show me the soccer match results for teams Inter Milan and AS Roma between

Description for AI

Access soccer match results from Agones. Keep in mind soccer is called football in Europe.
Results go back to 2007 until current games being played right now and all scheduled matches for the next 10 days.
Results cover most countries and leagues in the world.

  • Use single-line string for team1, team2 and all other parameters.
  • Pass date_from and date_until in a YYYY-MM-DD format
  • If one team is passed, returned matches will be about this team and any other opponent.
  • If two teams are passed, matches between these two teams will be returned.
  • if date_type is 'latest', then the most recent match will be returned.
  • If date_type is 'next', then the next match will be returned.
  • If date_type is 'range', then all matches between date_from and date_until will be returned.
  • Only use date_from and date_until when date_type is 'range' - otherwise these are not used.
  • If a match is currently live, the current minute will also be provided.

Results are an array of dictionaries in the format:
"home_team": "Liverpool",
"away_team": "Arsenal",
"match_date": "2023-05-02",
"state": "finished"
"score_halftime": "2 - 0",
"score_current": "4 - 0"

Similar Plugins and Alternatives