Unofficial Tapology API

Unofficial Tapology MMA API: Access fighter profiles, upcoming event schedules, and fight history.

• Comprehensive fighter profiles with details and stats
• Upcoming Event schedules per subregion
• Up-to-date upcoming, cancelled and past fight results
• Coverage of both amateur and professional fighters worldwide

Powered by Tapology, the world's largest fight database, for real-time accuracy.

原始信息汇总

Unofficial Tapology API 数据集概述

基本信息

• 数据集名称: Unofficial Tapology API
• 版本: 1.2.0 (当前版本)
• 数据来源: Tapology (世界最大的格斗数据库)
• 数据更新: 实时
• 免责声明: 此API未经Tapology认可或赞助，是一个仅用于信息目的的非官方服务。

核心功能

• 综合格斗选手资料: 获取全球MMA选手的详细信息，包括个人资料、历史战绩。
• 赛事日程: 获取即将到来和已过去的赛事日程。
• 比赛结果: 获取最新的、已取消的和过去的比赛结果。
• 覆盖范围: 涵盖全球业余和专业选手。

技术特性

• 高性能优化: 使用Redis缓存以实现更快的响应时间。
• 弹性设计: 采用断路器模式以抵御上游服务故障。
• 结构化响应: 格式良好的JSON数据，便于集成。
• 异步处理: 非阻塞I/O以实现高效的请求处理。

技术栈

• FastAPI: 现代高性能Web框架。
• Redis: 用于性能优化的高级缓存层。
• Python 3.12: 利用最新的语言特性。
• Docker: 容器化部署以实现环境一致性。

API端点

选手端点

1. 获取选手资料

   • 端点: GET /api/fighter/{fighter_id}
   • 描述: 检索选手的详细信息。
   • 路径参数: fighter_id (字符串，必需) - 选手的唯一标识符。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。
   • 响应字段示例: firstname, lastname, nickname, age, date_of_birth, born, weight_class, last_weigh_in, full_record, current_streak, last_fight, wins, losses, draws, no_contest, tko_ko, submission, decision, disqualification。

2. 批量获取选手资料

   • 端点: GET /api/fighter/profiles/{fighter_id}
   • 描述: 通过单个请求检索多个选手资料。
   • 查询参数: fighter_id (字符串，必需) - 逗号分隔的选手ID (最多3个)。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。

3. 获取选手比赛历史结果

   • 端点: GET /api/fighter/result/{fighter_id}
   • 描述: 检索选手的比赛历史和结果。
   • 路径参数: fighter_id (字符串，必需) - 选手的唯一标识符。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。
   • 响应字段示例: result, cancellation_reason, fighter_name, opponent_name, fighter_record_before_fight, opponent_record_before_fight, event, event_date, level, title_bout, billing, status_before_fight, weight, weigh_in_result, duration, odds, referee, fight_award, disclosed_pay。

4. 批量获取选手比赛结果

   • 端点: GET /api/fighter/results/{fighter_id}
   • 描述: 通过单个请求获取多个选手的比赛结果。
   • 查询参数: fighter_id (字符串，必需) - 逗号分隔的选手ID (最多3个)。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。

赛事端点

1. 获取即将到来的赛事日程

   • 端点: GET /api/schedule/events/{region_id}
   • 描述: 检索特定区域的即将到来的MMA赛事日程。
   • 路径参数: region_id (整数，必需) - 区域ID (1-121)。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。
   • 响应字段示例: organization, main_event, weight_class, datetime, city, subregion, broadcast, title_bout_desc, fight_card。

2. 批量获取多个区域的即将到来的赛事

   • 端点: GET /api/schedule/events/{regions_id}
   • 描述: 通过单个调用获取多个区域的赛事日程。
   • 查询参数: regions_id (字符串，必需) - 逗号分隔的区域ID (最多3个)。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。

3. 获取过去赛事

   • 端点: GET /api/schedule/past-events/{region_id}
   • 描述: 获取特定区域的过去赛事日程，包含增强的比赛卡详情。
   • 路径参数: region_id (整数，必需) - 区域ID (1-121)。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。
   • 查询参数: page (整数，可选) - 分页的页码 (默认: 1)。

4. 批量获取多个区域的过去赛事

   • 端点: GET /api/schedule/past-events/{regions_id}
   • 描述: 通过单个调用获取多个区域的过去赛事日程，包含增强的比赛卡详情。
   • 查询参数: regions_id (字符串，必需) - 逗号分隔的区域ID (最多3个)。
   • 查询参数: fields (字符串，可选) - 响应中包含的字段列表。
   • 查询参数: page (整数，可选) - 分页的页码 (默认: 1)。

区域覆盖

API为赛事日程覆盖多个区域，包括：

• 美国各州及区域 (例如: 内华达州、加利福尼亚州、美国西部)
• 加拿大 (例如: 魁北克省、安大略省)
• 欧洲 (例如: 英国与爱尔兰、德国、法国)
• 亚洲 (例如: 日本、东南亚、中国)
• 澳大利亚与新西兰
• 拉丁美洲 (例如: 巴西、墨西哥、阿根廷)
• 中东 (例如: 中东、巴林)
• 非洲 (例如: 南非、埃及)
• 其他次区域或大洲 (例如: 加勒比地区、北美、高加索地区)

定价结构

计划	价格	月度配额	使用场景
BASIC	免费	53 次请求	测试和评估
PRO	$12.99/月	3,250 次请求	个人开发者、小项目
MEGA	$30.00/月	32,000 次请求	高流量应用、企业

各计划功能

• BASIC: 仅限单区域/选手访问。
• PRO: 单次 + 批量访问 (有限制)。
• MEGA: 完全访问所有端点，拥有最高配额。

错误处理

API使用标准HTTP响应代码指示请求的成功或失败：

• 400: 错误请求 - 请求参数无效。
• 401: 未授权 - API密钥缺失或无效。
• 404: 未找到 - 请求的资源不存在。
• 429: 请求过多 - 超出速率限制。
• 500: 内部服务器错误 - 服务器端错误。

最佳实践

• 使用 fields 参数仅请求所需数据。
• 在客户端实施缓存以存储频繁访问的数据。
• 在请求中采用指数退避策略处理速率限制。
• 通过适当的归属尊重源数据。

更新日志

• 2025-04-01 (v1.3.0): 新的定价结构；新增增强的批量端点、过去赛事端点以及改进的错误处理；获取即将到来/过去赛事：每个请求最多允许3个区域ID；获取选手结果：每个请求最多允许3个选手ID。
• 2025-01-03 (v1.2.0): 性能优化和延迟减少。
• 2024-11-05 (v1.1.0): 简化身份验证流程。
• 2024-10-28 (v1.0.1): 首次稳定发布。

搜集汇总

背景与挑战

背景概述

该数据集是一个非官方的Tapology MMA API接口，提供全面的拳手资料、赛事日程和比赛结果数据，覆盖全球业余和专业选手。数据来源于世界最大的格斗数据库Tapology，确保实时准确性。