SofaScore API

Real-time sports data from SofaScore — matches, scores, lineups, statistics, standings, player profiles, and more across 24+ sports including football, basketball, and tennis.

原始信息汇总

SofaScore API 数据集概述

基本信息

• API名称: SofaScore API
• 当前版本: v1
• 数据来源: 从全球综合性实时比分平台 SofaScore 直接抓取
• 数据类型: 实时与历史体育数据
• 覆盖运动: 超过24种体育项目，包括足球（英式足球）、篮球、网球、曲棍球和电子竞技等。

核心特性

• 端点数量: 提供40个端点，覆盖体育数据的各个方面。
• 实时比赛数据: 包括事件（进球、红黄牌、换人）、阵容、统计数据、势头图表、最佳球员。
• 球队与球员档案: 完整的阵容名单、转会历史、职业生涯数据、球员特点。
• 赛事数据: 积分榜、赛季信息、杯赛树状图、顶级统计数据。
• 赛前洞察: 历史交锋记录、状态表、AI洞察、赔率。
• 广播信息: 每场比赛的电视转播频道。
• 搜索功能: 可按名称搜索球队、球员、赛事或经理。

端点类别

类别	端点描述
Schedule	按运动或赛事获取赛程
Events	比赛详情、事件、统计数据、阵容、历史交锋、赔率、电视频道
Teams	球队档案、阵容、近期/未来赛事、排名、表现
Players	球员档案、转会、特点、赛季数据
Tournaments	赛事详情、赛季、积分榜、杯赛树状图、顶级数据
Managers	教练档案
Search	跨实体搜索
Categories	国家/地区级别的赛事列表
News	最新体育新闻

订阅计划与定价

• BASIC: $0.00 / 月
• PRO: $12.00 / 月
• ULTRA: $49.00 / 月
• MEGA: $199.00 / 月

技术详情

• 基础URL: https://sofascore-api4.p.rapidapi.com
• 请求头:
  • x-rapidapi-host: sofascore-api4.p.rapidapi.com
  • x-rapidapi-key: YOUR_RAPIDAPI_KEY
• 响应格式: 成功响应返回HTTP 200状态码及JSON数据。
• 错误码:
  • 200: 成功
  • 404: 资源未找到
  • 422: 验证错误（需检查必要参数）
  • 502: 上游数据源不可用

主要端点示例

方法	路径	描述
GET	/api/v1/schedule/sport/{sport}/{date}	获取某运动在指定日期的所有比赛
GET	/api/v1/schedule/tournament/{id}/{date}	获取特定赛事在指定日期的比赛
GET	/api/v1/events/{id}	获取比赛详情（球队、比分、状态、轮次）
GET	/api/v1/events/{id}/incidents	获取比赛事件（进球、红黄牌、换人）
GET	/api/v1/events/{id}/statistics	获取比赛统计数据（控球率、射门、传球、角球等）
GET	/api/v1/events/{id}/lineups	获取比赛阵容（首发、替补、阵型、球员评分）
GET	/api/v1/events/{id}/h2h	获取两队历史交锋记录
GET	/api/v1/events/{id}/odds/{providerId}	获取比赛的所有投注市场赔率
GET	/api/v1/events/{id}/tv-channels	获取按国家分类的电视转播频道
GET	/api/v1/teams/{id}	获取球队档案（名称、国家、颜色、体育场）
GET	/api/v1/players/{id}	获取球员档案（位置、年龄、惯用脚、市场价值）
GET	/api/v1/tournaments/{id}/seasons/{seasonId}/standings/{type}	获取联赛积分榜（总榜/主场/客场）
GET	/api/v1/search?q={query}	搜索球员、球队、赛事、经理

参数参考

通用ID示例

实体	示例ID	示例名称
Tournament	7	UEFA Champions League
Tournament	17	Premier League
Season	76953	UCL 2025/26
Team	2829	Real Madrid
Player	826643	Kylian Mbappé
Event	13981731	Como vs Udinese (Serie A, finished)

支持的体育项目

football, basketball, tennis, baseball, ice-hockey, volleyball, rugby, handball, cricket

使用说明

• 日期格式: 必须为 YYYY-MM-DD 格式。
• 分页: 路径中包含 /{page} 的端点使用从0开始的分页（page=0 为第一页）。响应中的 hasNextPage 字段可用于判断是否有更多结果。
• 赛事统计数据分页: 使用查询参数 ?limit=20&offset=0。
• ID传递: 所有数字ID在路径参数中应作为字符串传递。
• 积分榜类型参数: type 参数接受 total、home、away。

限制与说明

• 投注赔率可能并非对所有比赛或所有地区都可用。
• AI洞察仅适用于已结束的比赛。
• 杯赛树状图仅适用于淘汰赛制比赛。