Football Pro

Sportmonks Football API v3.0 is a comprehensive RESTful API providing access to football (soccer) data across 2,300+ leagues worldwide. The API delivers real-time livescores, fixtures, statistics, odds, player data, and much more in JSON format.

原始信息汇总

Football Pro 数据集概述

数据集基本信息

• 数据集名称：Football Pro
• 提供商：Sportmonks
• 访问方式：API
• 当前版本：v1
• 定价模式：Freemium（免费版有限制）
• 免费限制：8 次请求/小时
• 服务等级：100%
• 平均延迟：429ms
• 受欢迎度评分：9.9

定价计划

• BASIC：$0.00 / 月
• PRO：$279.00 / 月
• ULTRA：$349.00 / 月
• MEGA：$499.00 / 月

核心特性

• 灵活API结构：以更少的API请求获取更多数据
• 可定制响应：仅构建所需数据的API响应
• 全面覆盖：访问全球900+个足球联赛
• 实时数据：每秒更新实时比分，通常比竞争对手快15秒以上
• 高效设计：1次请求可替代10次单独请求
• 时区支持：默认UTC，可通过tz参数覆盖
• 分页机制：超过1000条结果时自动分页，每页100条结果

数据覆盖范围

• 联赛数量：900+（另有描述为1300+）
• 注册用户：20,000+（另有描述为14,000+）
• 覆盖类型：全球联赛，支持自定义计划选择特定联赛

API端点分类

1. 赛程

提供特定联赛中比赛的信息。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/fixtures/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/livescores/now
  • GET https://football-pro.p.rapidapi.com/api/v2.0/fixtures/between/{STARTDATE}/{ENDDATE}
• 可用包含项：localTeam, visitorTeam, substitutions, corners, comments, tvstations, round, stage, referee, venue, odds, inplayOdds, flatOdds, localCoach, visitorCoach, group, trends, firstAssistant, secondAssistant, fourthOfficial, league

2. 联赛

返回基于订阅计划可访问的所有联赛。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/leagues
  • GET https://football-pro.p.rapidapi.com/api/v2.0/leagues/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/leagues/search/{SEARCH}

3. 赛季

提供赛季详情，包括ID、名称、联赛ID、年份和活跃状态。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/seasons
  • GET https://football-pro.p.rapidapi.com/api/v2.0/seasons/{ID}

4. 轮次

代表比赛进行的周次。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/rounds/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/rounds/season/{ID}

5. 阶段

定义特定联赛/赛季的当前阶段或设置。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/stages/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/stages/season/{ID}

6. 排名

不同联赛中球队的排名。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/standings/season/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/standings/season/live/{ID}

7. 球队与阵容

查找所有球队详情。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/teams/{ID}&seasons={ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/teams/season/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/teams/search/{SEARCH}

8. 球员与教练

详细的球员和教练信息。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/players/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/players/search/{SEARCH}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/coaches/{ID}

9. 场馆

详细的场馆信息。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/venues/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/venues/season{ID}

10. 最佳射手

关于进球、红黄牌和助攻的最佳射手的准确信息。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/seasons/{ID}（需包含特定字段）

11. 大洲与国家

将国家和联赛分配到大洲。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/countries
  • GET https://football-pro.p.rapidapi.com/api/v2.0/continents
  • GET https://football-pro.p.rapidapi.com/api/v2.0/countries/{ID}

12. 赛前与实时赔率

用于添加投注功能的赔率。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/odds/inplay/fixture/{ID}
  • GET https://football-pro.p.rapidapi.com/api/v2.0/odds/fixture/{ID}

13. 博彩公司与赔率市场

用于检查和组织博彩公司与市场可用性。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/bookmakers
  • GET https://football-pro.p.rapidapi.com/api/v2.0/markets
  • GET https://football-pro.p.rapidapi.com/api/v2.0/markets/{ID}

14. 阵容

赛程或球员的阵容信息。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/fixtures/{ID}（需包含lineup）
  • GET https://football-pro.p.rapidapi.com/api/v2.0/players/{ID}（需包含lineup）

15. 统计

访问球队、球员和赛季在各个层面的所有统计数据。

• 端点示例：
  • GET https://football-pro.p.rapidapi.com/api/v2.0/fixtures/{ID}（需包含stats或lineup.player）
  • GET https://football-pro.p.rapidapi.com/api/v2.0/teams/{ID}（需包含stats）
  • GET https://football-pro.p.rapidapi.com/api/v2.0/seasons/{ID}（需包含stats）

其他功能端点

• 替补球员：GET https://football-pro.p.rapidapi.com/api/v2.0/benched/{ID}
• 评论：GET https://football-pro.p.rapidapi.com/api/v2.0/comments/fixture/{ID}
• 伤病名单：GET https://football-pro.p.rapidapi.com/api/v2.0/sidelined/player/{ID}
• 视频集锦：GET https://football-pro.p.rapidapi.com/api/v2.0/highlights/fixture/{ID}
• 电视台：GET https://football-pro.p.rapidapi.com/api/v2.0/tvstations/fixture/{ID}
• 趋势：GET https://football-pro.p.rapidapi.com/api/v2.0/trends/fixture/{ID}
• 转会：GET https://football-pro.p.rapidapi.com/api/v2.0/transfers/player/{ID}

支持与文档

• 官方文档：https://docs.sportmonks.com/football
• 覆盖范围查看：https://sportmonks.com/football-api/coverage
• 技术支持邮箱：[e-mail]
• 时区列表参考：Wikipedia - List of tz database time zones