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 平均响应

API 文档

端点

请求

“比赛日程”端点提供了特定比赛中所有比赛的全面摘要,详细列出了每场比赛的基本属性,如参与的队伍、比赛时间、得分和状态更新。此端点旨在便于实时跟踪和管理比赛进程,非常适合于实时体育应用、比赛组织者以及希望及时了解自己喜欢的队伍表现的球迷。该端点返回的数据可用于生成排行榜、提供实时评论或为即将到来的比赛创建通知,从而增强用户体验和对比赛生态系统的参与度
Endpoint ID: 26352
GET https://docs.zylalabs.com/api/13052/api+football/26352/tournament+games
输入参数

剩余免费测试请求:3 / 3。


输入参数

此端点不需要任何输入参数。

API 示例响应
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"}
锦标赛游戏 — 代码片段

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


    
请求

"赛事游戏概述"端点提供指定赛事中所有比赛的综合摘要,显示参与队伍、比赛时间表、得分和状态更新等重要信息。该端点旨在方便访问比赛数据,使开发者和体育分析师能够获取关于正在进行或已完成比赛的详细见解。潜在的使用案例包括将该端点集成到体育分析应用中,通过实时更新赛事进展来增强粉丝的参与感,或创建监控队伍在比赛中表现的排行榜功能

Endpoint ID: 26459
GET https://docs.zylalabs.com/api/13052/api+football/26459/tournament+games+overview
输入参数

比赛游戏概述 — 端点功能

对象 描述
tournament_id 必需 tournament_id

剩余免费测试请求:3 / 3。


输入参数

tournament_id
API 示例响应
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"}
比赛游戏概述 — 代码片段

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 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 API Football 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

⚽ 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

该端点返回与各种足球比赛中正在进行的比赛相关的数据 包括比赛状态 参与的球队 得分 和其他相关的比赛细节

关键字段包括“状态”、“响应”、“项目”、“总项目数”、“总页数”和“日期时间”。“项目”数组包含详细的匹配信息,而“总项目数”指示返回的匹配数量

响应采用JSON格式结构。它包含一个指示请求结果的“status”字段,一个带有匹配详细信息的“response”对象,以及类似“etag”和“api_version”的元数据

用户可以使用参数自定义他们的请求,例如“per_page”(每页结果数)、“paged”(页码)、“timezone”(比赛时间的时区)和“status”(按比赛状态筛选)

该端点提供有关比赛比分、球队阵容、比赛状态以及控球和射门等统计数据的信息,使用户能够全面跟踪实时比赛动态

数据准确性通过与可靠的体育数据提供商的合作以及持续监控比赛事件来维护,以确保实时更新反映实际比赛情况

典型的用例包括实时比分追踪 体育分析 和为体育新闻应用提供实时更新 增强比赛期间用户的参与度

用户应检查“total_items”字段;如果为零,则没有可用的匹配项。对于部分结果,他们可以调整“per_page”或“paged”等参数,以优化查询以获取更全面的数据

用户可以使用“per_page”等参数自定义请求,以设置每页的结果数,“paged”以指定页码,“timezone”用于比赛时间,“status”以根据当前状态过滤比赛

“items”数组包含有关每场比赛的详细信息,包括球队、得分和统计数据。数组中的每个对象对应于当前进行的特定比赛

“total_pages”字段指示基于当前查询参数可用的结果总页数。这帮助用户浏览多个匹配数据的页面

用户可以利用返回的数据进行实时比分更新 体育分析以及在应用程序中通过显示实时比赛统计和评论来增强用户互动

API足球覆盖全球主要足球联赛和比赛,包括英超联赛、西甲、意甲、德甲和冠军联赛,确保全面的全球覆盖

数据质量通过与信誉良好的体育数据提供商的合作、对比赛事件的持续监控以及严格的验证流程来确保准确性和可靠性

如果响应为空,请检查“total_items”字段;如果显示为零,则没有可用的匹配项。调整您的参数,例如“status”或“timezone”,以优化查询以获得更好的结果

响应包括比赛细节如球队名称 当前比分 比赛状态(例如 进行中 完成) 比赛时间以及如控球和射门等统计数据 这使用户能够全面跟踪比赛进程

您可以使用“状态”参数来过滤比赛。接受的值通常包括“进行中”“已结束”或“即将开始”,允许您只检索符合您标准的比赛

"etag"字段是响应数据的唯一标识符,用于缓存目的。它帮助客户端判断自上一次请求以来数据是否已更改,从而优化数据检索

您可以调整“per_page”参数来指定每页希望获得的结果数量。例如,将“per_page=10”设置为返回响应中的十个匹配项。

API足球涵盖了全球范围内的众多联赛和比赛,包括英超联赛、西甲联赛、意甲联赛、德甲联赛以及国际锦标赛如冠军联赛

“total_items”字段表示根据您的查询参数可用的匹配项总数。这有助于您了解返回数据的范围以及是否需要进一步过滤

“datetime”字段提供了响应生成时的时间戳。这对于跟踪数据的最新性和确保查看最新的比赛信息是有用的

虽然GET比赛比赛列表端点主要关注比赛数据 但您可以从API中集成实时评论 通过在比赛期间提供实时更新和见解来增强用户参与度

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API