future football performance API

Football Performance API provides structured football data for player ratings, role-based analysis, and performance insights across major leagues. It is designed for developers, analysts, and football platforms that need fast, reliable access to football metrics and model-driven outputs.

原始信息汇总

好的，这是您提供的数据集详情页面的关键信息总结。

数据集概述：Future Football Performance API

这是一个基于RESTful架构的足球运动员表现预测API，由Futrix Metrics提供。它通过机器学习模型，为开发者、分析师和球探提供结构化的足球数据，包括球员评分、基于角色的分析以及表现洞察。

核心功能

• 评分与预测：通过提交球员的原始统计数据（特征向量），基于Base模型和Pro模型预测球员的表现得分。
• 数据库查询：支持以GET请求方式，分页查询球员评分记录和角色聚类分类结果。
• 图表与可视化：提供用于构建内部仪表盘或嵌入应用的数据，包括模型性能、特征重要性、位置和联赛分布等。
• 报告生成：可生成包含球员完整信息的HTML格式球探报告。

端点概览

• 数据库（Database）
  • GET /database/ratings：检索球员评分记录。
  • GET /database/role-cluster-results：检索个人球员的角色聚类分类结果。
  • GET /database/role-cluster-summary：检索每个角色聚类的汇总元数据。
• 评分与预测（Score & Prediction）
  • GET /score/：评分服务的健康与状态检查。
  • POST /score/predict：基于Pro模型提交球员统计数据，进行表现评分预测。
  • POST /score/predict-base：基于Base模型进行表现评分预测。
• 图表与可视化（Charts & Visualisation）
  • GET /charts/overview：模型覆盖率和性能统计概览。
  • GET /charts/positions：球员位置分布数据。
  • GET /charts/leagues：联赛分布数据。
  • GET /charts/models/base：Base模型性能指标与图表数据。
  • GET /charts/models/pro：Pro模型性能指标与图表数据。
  • GET /charts/features：Base与Pro模型间特征使用差异排名。
• 报告（Reports）
  • GET /report：生成指定球员的详细HTML格式球探报告。
• 系统（System）
  • GET /health：检查API操作状态（无需认证）。

关键信息

项目	说明
基础URL	https://footballperformanceapi.site
API版本	1.0.0
认证方式	API Key，通过 X-API-Key 请求头传递
请求格式	application/json
响应格式	application/json（/report 端点返回 text/html）
分页	数据库端点支持 limit（最多5000）和 offset 参数的偏移量分页
订阅方案	提供免费BASIC、付费PRO、ULTRA、MEGA等多种方案

主要数据模型：PredictRequest

该模型用于评分与预测端点，包含一个 features 对象，其中可以包含球员的姓名、位置、联赛、球队、赛季以及各项技术统计（如出场时间、进球、助攻、传球、抢断等）。