API Football

API ID 13052

Stay ahead of every match with the fastest football live scores app built for real fans. Get real-time score updates, detailed match statistics, and live commentary from leagues and competitions around the world.

599 ms avg response

API Documentation

Endpoints

Request

The "Tournament Games" endpoint provides a comprehensive summary of all games scheduled within a specific tournament, detailing each game's essential attributes such as teams participating, match timings, scores, and status updates. This endpoint is designed to facilitate real-time tracking and management of tournament progress, making it ideal for live sports applications, tournament organizers, and fans who wish to stay updated on their favorite teams' performances. The data returned by this endpoint can be utilized to generate leaderboards, provide live commentary, or create notifications for upcoming matches, thereby enhancing the overall user experience and engagement in the tournament's ecosystem.

Endpoint ID: 26352
GET https://zylalabs.com/api/13052/api+football/26352/tournament+games
INPUT PARAMETERS

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{"status":"ok","response":{"items":[{"cid":"1382","cname":"FIFA World Cup","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/logo_5d515bc2320a6.png","matches":[{"mid":"305534","round":"Round of 32","group":"","result":{"home":"2","away":"1","winner":"home"},"teams":{"home":{"tid":"11","tname":"England","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4713.png","fullname":"England","abbr":"ENG","card":""},"away":{"tid":"1298","tname":"Congo DR","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4823.png","fullname":"DR Congo","abbr":"COD","card":""}},"periods":{"p1":{"home":0,"away":1},"p2":{"home":2,"away":0},"ft":{"home":2,"away":1}},"datestart":"2026-07-01 16:00:00","timestampstart":1782921600,"time":"90","status":"2"},{"mid":"305531","round":"Round of 32","group":"","result":{"home":"2","away":"0","winner":"home"},"teams":{"home":{"tid":"25","tname":"Mexico","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4781.png","fullname":"Mexico","abbr":"MEX","card":""},"away":{"tid":"1154","tname":"Ecuador","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4757.png","fullname":"Ecuador","abbr":"ECU","card":"1"}},"periods":{"p1":{"home":2,"away":0},"p2":{"home":0,"away":0},"ft":{"home":2,"away":0}},"datestart":"2026-07-01 02:00:00","timestampstart":1782871200,"time":"90","status":"2"},{"mid":"305529","round":"Round of 32","group":"","result":{"home":"3","away":"0","winner":"home"},"teams":{"home":{"tid":"2","tname":"France","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4481.png","fullname":"France","abbr":"FRA","card":""},"away":{"tid":"3","tname":"Sweden","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/4688.png","fullname":"Sweden","abbr":"SWE","card":""}},"periods":{"p1":{"home":1,"away":0},"p2":{"home":2,"away":0},"ft":{"home":3,"away":0}},"datestart":"2026-06-30 21:00:00","timestampstart":1782853200,"time":"90","status":"2"}]},{"cid":"1893","cname":"Brasileiro Serie B","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/162.png","matches":[{"mid":"394492","round":"15","group":"","result":{"home":"0","away":"1","winner":"away"},"teams":{"home":{"tid":"14389","tname":"botafogosp","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/1979.png","fullname":"botafogosp","abbr":"BOT","card":""},"away":{"tid":"147","tname":"CRB AL","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/22032.png","fullname":"CRB AL","abbr":"CRB","card":""}},"periods":{"p1":{"home":0,"away":1},"p2":{"home":0,"away":0},"ft":{"home":0,"away":1}},"datestart":"2026-06-30 23:00:00","timestampstart":1782860400,"time":"90","status":"2"}]},{"cid":"2155","cname":"Canadian Premier League","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/167.png","matches":[{"mid":"449840","round":"1","group":"","result":{"home":"3","away":"2","winner":"home"},"teams":{"home":{"tid":"3923","tname":"Forge","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/313716.png","fullname":"Forge FC Hamilton","abbr":"FOR","card":""},"away":{"tid":"11421","tname":"Vancouver FC","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/463097.png","fullname":"Vancouver FC","abbr":"VAN","card":""}},"periods":{"p1":{"home":0,"away":2},"p2":{"home":3,"away":0},"ft":{"home":3,"away":2}},"datestart":"2026-07-01 17:00:00","timestampstart":1782925200,"time":"90","status":"2"}]},{"cid":"2156","cname":"Vysshaya Liga","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/73.png","matches":[{"mid":"450132","round":"14","group":"","result":{"home":"2","away":"4","winner":"away"},"teams":{"home":{"tid":"1540","tname":"Slavia Mozyr","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/3358.png","fullname":"FC Slavia Mozyr","abbr":"SLM","card":"1"},"away":{"tid":"4298","tname":"Maxline Rogachev","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/381792.png","fullname":"Maxline Rogachev","abbr":"MAX","card":""}},"periods":{"p1":{"home":1,"away":2},"p2":{"home":1,"away":2},"ft":{"home":2,"away":4}},"datestart":"2026-07-01 17:30:00","timestampstart":1782927000,"time":"90","status":"2"}]},{"cid":"2175","cname":"Virsliga","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/265.png","matches":[{"mid":"452074","round":"21","group":"","result":{"home":"1","away":"2","winner":"away"},"teams":{"home":{"tid":"5649","tname":"Tukums 2000","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/36080.png","fullname":"FK Tukums 2000\/TSS","abbr":"TUK","card":""},"away":{"tid":"16349","tname":"sk super nova","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/282126.png","fullname":"sk super nova","abbr":"SUN","card":""}},"periods":{"p1":{"home":1,"away":1},"p2":{"home":0,"away":1},"ft":{"home":1,"away":2}},"datestart":"2026-07-01 15:00:00","timestampstart":1782918000,"time":"90","status":"2"}]},{"cid":"2176","cname":"1 Lyga","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/273.png","matches":[{"mid":"452405","round":"1","group":"","result":{"home":"0","away":"1","winner":"away"},"teams":{"home":{"tid":"17404","tname":"atmosfera mazeikiai","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/254328.png","fullname":"atmosfera mazeikiai","abbr":"ATM","card":""},"away":{"tid":"15443","tname":"be1 nfa","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/378800.png","fullname":"be1 nfa","abbr":"BE1","card":""}},"periods":{"p1":{"home":0,"away":1},"p2":{"home":0,"away":0},"ft":{"home":0,"away":1}},"datestart":"2026-07-01 16:00:00","timestampstart":1782921600,"time":"90","status":"2"},{"mid":"452404","round":"1","group":"","result":{"home":"1","away":"3","winner":"away"},"teams":{"home":{"tid":"17925","tname":"fa siauliai b","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/350213.png","fullname":"fa siauliai b","abbr":"SIA","card":""},"away":{"tid":"15441","tname":"fk tauras","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/35389.png","fullname":"fk tauras","abbr":"TAU","card":""}},"periods":{"p1":{"home":1,"away":0},"p2":{"home":0,"away":3},"ft":{"home":1,"away":3}},"datestart":"2026-07-01 15:00:00","timestampstart":1782918000,"time":"90","status":"2"}]},{"cid":"2179","cname":"Brasileiro Serie C","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/competition\/395.png","matches":[{"mid":"453173","round":"12","group":"Brasileiro Serie C","result":{"home":"3","away":"0","winner":"home"},"teams":{"home":{"tid":"4423","tname":"Volta Redonda","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/6982.png","fullname":"Volta Redonda FC RJ","abbr":"VOR","card":""},"away":{"tid":"8014","tname":"Amazonas FC AM","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/336664.png","fullname":"Amazonas FC AM","abbr":"AMA","card":""}},"periods":{"p1":{"home":0,"away":0},"p2":{"home":3,"away":0},"ft":{"home":3,"away":0}},"datestart":"2026-06-30 23:30:00","timestampstart":1782862200,"time":"90","status":"2"},{"mid":"453172","round":"12","group":"Brasileiro Serie C","result":{"home":"2","away":"0","winner":"home"},"teams":{"home":{"tid":"14670","tname":"botafogopb","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/49196.png","fullname":"botafogopb","abbr":"BOT","card":""},"away":{"tid":"4469","tname":"Brusque","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/21884.png","fullname":"Brusque FC SC","abbr":"BRU","card":""}},"periods":{"p1":{"home":0,"away":0},"p2":{"home":2,"away":0},"ft":{"home":2,"away":0}},"datestart":"2026-06-30 23:30:00","timestampstart":1782862200,"time":"90","status":"2"},{"mid":"453171","round":"12","group":"Brasileiro Serie C","result":{"home":"1","away":"1","winner":"draw"},"teams":{"home":{"tid":"7350","tname":"Caxias do Sul","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/2000.png","fullname":"SER Caxias do Sul","abbr":"CAX","card":""},"away":{"tid":"8010","tname":"Anapolis FC GO","logo":"https:\/\/gcdnimages.entitysport.com\/soccer\/team-s2\/21872.png","fullname":"Anapolis FC GO","abbr":"ANA","card":""}},"periods":{"p1":{"home":0,"away":0},"p2":{"home":1,"away":1},"ft":{"home":1,"away":1}},"datestart":"2026-06-30 22:30:00","timestampstart":1782858600,"time":"90","status":"2"}]}],"total_items":7,"total_pages":1},"etag":"63d8e956eae64ce450f140cad53bac25","modified":"2026-07-06 03:39:48","datetime":"2026-07-06 03:39:48","api_version":"1.0"}
Tournament Games — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13052/api+football/26352/tournament+games' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

The "Tournament Games Overview" endpoint provides a comprehensive summary of all games within a specified tournament, displaying vital information such as the participating teams, match schedules, scores, and status updates. This endpoint is designed to facilitate easy access to game data, allowing developers and sports analysts to retrieve detailed insights regarding ongoing or completed matches in a tournament format. Potential use cases include integrating the endpoint into sports analytics applications, enhancing fan engagement through live updates on tournament progress, or creating leaderboard features that monitor team performance throughout the competition.

Endpoint ID: 26459
GET https://zylalabs.com/api/13052/api+football/26459/tournament+games+overview
INPUT PARAMETERS

Tournament Games Overview — Endpoint Features

Object Description
tournament_id Required tournament_id

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

tournament_id
API EXAMPLE RESPONSE
JSON
{"status":"ok","response":{"items":[{"sid":"25-26","name":"25-26","competition_id":"1914"},{"sid":"24-25","name":"24-25","competition_id":"1915"},{"sid":"23-24","name":"23-24","competition_id":"1916"},{"sid":"22-23","name":"22-23","competition_id":"1952"},{"sid":"21-22","name":"21-22","competition_id":"1953"},{"sid":"20-21","name":"20-21","competition_id":"1954"}],"total_items":6,"total_pages":1},"etag":"f8db301d891dd75155a3d5c3ed3a94df","modified":"2026-07-06 03:49:57","datetime":"2026-07-06 03:49:57","api_version":"1.0"}
Tournament Games Overview — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13052/api+football/26459/tournament+games+overview?tournament_id=3' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the API Football simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

🚀 Enterprise Plan

Starts at
$ 10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring
zeiss-logo amazon-logo zoom-logo decathlon-logo

Trusted by leading companies

Overview

⚽ Live Football Scores
Get instant updates from ongoing matches with lightning-fast live scores. Never miss a goal, card, or key moment again.

📊 Detailed Match Stats
Dive deep into team and player performance with comprehensive football statistics including possession, shots, lineups, head-to-head records, and more.

🗣️ Live Commentary
Follow every match with real-time text commentary. Experience the game even when you can't watch it live.

🏆 All Major Leagues Covered
Track matches from top football leagues and tournaments including Premier League, La Liga, Serie A, Bundesliga, Champions League, and more.

📅 Match Schedules & Fixtures
Stay updated with upcoming matches, fixtures, and match timings so you never miss your favorite team in action.

API Football FAQs

This endpoint returns data related to ongoing matches in various football competitions. It includes match status, teams involved, scores, and other relevant match details.

Key fields include "status," "response," "items," "total_items," "total_pages," and "datetime." The "items" array contains detailed match information, while "total_items" indicates the number of matches returned.

The response is structured in a JSON format. It contains a "status" field indicating the request outcome, a "response" object with match details, and metadata like "etag" and "api_version."

Users can customize their requests using parameters such as "per_page" (number of results per page), "paged" (page number), "timezone" (time zone for match times), and "status" (filter by match status).

This endpoint provides information on match scores, team lineups, match status, and statistics like possession and shots, allowing users to track live match developments comprehensively.

Data accuracy is maintained through partnerships with reliable sports data providers and continuous monitoring of match events to ensure real-time updates reflect actual game conditions.

Typical use cases include live score tracking, sports analytics, and providing real-time updates for sports news applications, enhancing user engagement during matches.

Users should check the "total_items" field; if it is zero, no matches are available. For partial results, they can adjust parameters like "per_page" or "paged" to refine their queries for more comprehensive data.

Users can customize requests using parameters like "per_page" to set the number of results per page, "paged" to specify the page number, "timezone" for match times, and "status" to filter matches by their current state.

The "items" array contains detailed information about each match, including teams, scores, and statistics. Each object within the array corresponds to a specific match currently being played.

The "total_pages" field indicates the total number of pages available for the results based on the current query parameters. This helps users navigate through multiple pages of match data.

Users can leverage the returned data for live score updates, sports analytics, and enhancing user engagement in applications by displaying real-time match statistics and commentary.

API Football covers major football leagues and tournaments worldwide, including the Premier League, La Liga, Serie A, Bundesliga, and the Champions League, ensuring comprehensive global coverage.

Data quality is ensured through partnerships with reputable sports data providers, continuous monitoring of match events, and rigorous validation processes to maintain accuracy and reliability.

If the response is empty, check the "total_items" field; if it shows zero, no matches are available. Adjust your parameters, such as "status" or "timezone," to refine your query for better results.

The response includes match details such as team names, current scores, match status (e.g., live, finished), match time, and statistics like possession and shots. This allows users to track the game's progress comprehensively.

You can use the "status" parameter to filter matches. Accepted values typically include "live," "finished," or "upcoming," allowing you to retrieve only the matches that meet your criteria.

The "etag" field is a unique identifier for the response data, used for caching purposes. It helps clients determine if the data has changed since the last request, optimizing data retrieval.

You can adjust the "per_page" parameter to specify the number of results you want per page. For example, setting "per_page=10" will return ten match entries in the response.

The API Football covers a wide range of leagues and competitions globally, including top leagues like the Premier League, La Liga, Serie A, Bundesliga, and international tournaments like the Champions League.

The "total_items" field indicates the total number of matches available based on your query parameters. This helps you understand the scope of the data returned and whether further filtering is needed.

The "datetime" field provides the timestamp of when the response was generated. This is useful for tracking the recency of the data and ensuring you are viewing the latest match information.

While the GET Competition Matches List endpoint primarily focuses on match data, you can integrate live commentary from the API to enhance user engagement by providing real-time updates and insights during matches.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs