Logo Logo
Logo
  • Home
  • Prices
  • Competitions
    • All Competitions
    • World Cup API
  • Documentation
    • Football API Documentation
    • Live Match Commentary
  • Help
    • FAQ
    • Contact
  • 🔍
  • Login
  • Register

Football API Documentation

  • Livescores
  • Match Commentary
  • Football Fantasy
  • Fixtures API
  • Match events
  • Match statistics
  • Match lineups
  • Competition Squads
  • Competition Rosters
  • Match History
  • Head 2 Head
  • Live Standings
  • Standings
  • Group Standings
  • Top goalscorers
  • Top disciplinary
  • Countries
  • Flags
  • Competitions
  • Groups
  • Federations
  • Teams List
  • Team last matches
  • Team Event Minutes
  • Seasons
  • JSON Data
  • Response Structure
  • Common Errors
  • Languages
  • Validate Key

Build faster with comprehensive football data and developer-friendly documentation. Our football API gives you access to more than 400 competitions in over 30 languages, covering domestic leagues, international tournaments, national cups and more. Whether you’re building a website, mobile app or analytics platform, you’ll find the data you need in one place.

Our football API works with any programming language or tool that supports HTTP or HTTPS, including Python, PHP, Java, Node.js, Go, C#, Ruby, Swift and many others. You can also test endpoints using Postman, cURL, your browser or your preferred development tools. Every endpoint includes example requests and code snippets to help you integrate quickly.

Need more help? Visit our FAQ, contact our support team, or watch our video tutorials to learn how to build a live score website using our football API.

After creating an account, you’ll receive your football API key and secret from your profile page. These credentials are all you need to start making requests

Stay logged in while browsing the documentation to see every endpoint pre-filled with your own API credentials. This makes it easy to copy requests, test endpoints and speed up development. If you’re not logged in, you’ll see demo credentials, which are provided for documentation purposes only and do not return live data.


Live Scores API

Access live scores for matches currently in progress, along with recently completed fixtures from the last few hours. Filter results by competition, team and other parameters to retrieve only the data your application needs.

Continue reading...

Fixtures API

Retrieve upcoming fixtures across supported competitions, often covering the entire current season. Powerful filtering options make it easy to find the exact matches you’re looking for.

Continue reading...

History API

Access historical match data to analyse past performances, results and events. Combined with our live scores and fixtures endpoints, you’ll have complete coverage of football data across past, present and future matches.

Continue reading...

Match Commentary API

Add live text commentary to your application with detailed descriptions of key moments as they happen. Each event also includes supporting metadata, including the players involved, teams, and on-pitch event locations.

Continue reading...

Match Events API

Go beyond the scoreline with detailed match events, including goals, cards, penalties, substitutions and much more. With these and many more event types available, you can create rich, real-time football experiences for your users.

Continue reading...

Statistics API

Access up to 20 different match statistics, including possession, shots, corners, throw-ins, attacks, dangerous attacks and more. Statistics are available for both teams, helping you deliver deeper match analysis and insights.

Continue reading...

Match Lineups API

Access complete team lineups before kick-off, including starting elevens and substitutes. Give your users a full picture of how both teams are set up before the match begins.

Continue reading...

Live Standings API

Display live competition standings that update automatically as match events happen. As scores change, rankings and qualification positions are recalculated in real time, making this endpoint ideal for group stages and decisive final-round fixtures.

Continue reading...

Standings API

Retrieve complete league tables and competition standings, including rankings, points, promotion, qualification, and relegation positions. Keep your users informed throughout every stage of the competition.

Continue with single group standings... Continue with full competition standings...

Top Goalscorers API

Access the leading goalscorers across supported competitions, along with player performance data and team statistics. Track the race for the Golden Boot with detailed information on the top 15 to 20 scorers in each competition.

Continue reading...

Groups API

Retrieve group information for competitions that use group stages, from international tournaments like the World Cup to multi-stage competitions. This endpoint works seamlessly with the standings football API endpoints to provide the complete competition structure.

Continue reading...

Competitions List API

Browse every competition supported by our football API, including domestic leagues, national cups, international club tournaments, and international competitions. Use built-in filters to find competitions relevant to your application quickly.

Continue reading...

Top Disciplinary API

Track the players with the most yellow and red cards across supported competitions. Use disciplinary data alongside goalscorer and performance statistics to give your users a more complete picture of player performance.

Continue reading...

Competition Squads API

Access finalized team squads for major international competitions, including tournaments such as the UEFA EURO. Retrieve the squad for an individual team or access rosters for every team in the competition.

Continue reading for a single team... Continue reading for all teams...

Teams List API

Access teams from around the world and use filters to retrieve exactly the data you need. Team names are available in multiple languages, including Russian, Arabic, and Farsi, while each unique team ID can be used across other football API endpoints.

Continue reading...

Head2Head Comparison API

Compare two teams using their historical performances and recent head-to-head results. Retrieve wins, losses, and draws from the last six matches with a single football API call, giving you the data to power team comparisons, match previews, and prediction features.

Continue reading...

Last Matches API

Quickly retrieve a team’s most recent matches without searching through its complete history. The Last Matches endpoint makes it easy to access recent results and analyse current form.

Continue reading...

Team event minutes

Analyse when key events occur during matches with historical event data for one or multiple teams. Explore goals and other events by match minute using completed match data, ideal for building statistics, visualizations, and performance analysis tools.

Continue reading...

Countries List API

Access the full list of countries supported by our football API. Use the is_real: 1 value to identify recognised countries and access the relevant country data for your application.

Continue reading...

Federations List API

Access international football federations such as FIFA, UEFA and CONMEBOL, each with its own unique ID. Use federation IDs to filter competitions, matches and teams across the football API.

Continue reading...

Countries Flags API

Add country flags to national team information across your website or app. Retrieve flags through a dedicated football API API endpoint using the national team’s team_id, available from the Teams endpoint.

Continue reading...

Seasons List API

Retrieve a complete list of current and historical football seasons through a single endpoint. Our football API supports competitions that follow calendar-year seasons as well as those that run across two years, helping you keep your data aligned with each competition.

Continue reading...

Verify Key and Secret

Verify the API key and secret that give you access to the football API. Keep your credentials secure to prevent unauthorised users from consuming your request quota and regenerate them if you believe they have been exposed.

Continue reading...

Data Formats

All football API endpoints return data in JSON format, providing a lightweight, easy-to-use structure for integrating football data into your website, app, or other application.

Continue reading...

Standard Errors

Learn about the most common errors you may encounter when using our football API endpoints. Use this guide to understand API errors and account for potential network issues when building and maintaining your integration.

Continue reading...

Didn't find what you need?

Do no hesitate to contact us. We will get back to you as soon as possible.

Navigation

  • Home
  • Documentation
  • Prices
  • Competitions
  • Register
  • Contact
  • Terms
  • Blog

Major Competitions

  • All Competitions
  • World Cup API

Documentation!

  • API Documentation
  • Match Commentary

Social


  • Facebook
  • Twitter
  • YouTube
  • LinkedIn


Sitemaps


Sitemap in English Sitemap en Español
Logo

With 12 years of experience, football API develops and supports high-quality API data endpoints. We provide live scores, fixtures, history, match events, match statistics, standings, lineups, squads, odds, player statistics, live match commentary, live standings, goalscores, disciplinary, logos, flags, photos, and more.

© 2014 - 2026 All Rights Reserved football-api.com