future football performance API
FutrixMetrics Football Data API provides structured football player statistics, performance ratings, and career trajectory insights for developers, analysts, scouts, and football data platforms. With this API, you can access player-level data, season-by-season performance indicators, statistical comparisons, and AI-powered player evaluation outputs. It is designed for building football analytics…
future football performance API endpoints
| Method | Endpoint | Description |
|---|---|---|
| score | ||
| GET |
root_score__get /score/ |
Returns a short service status message and a ready-to-copy single-player prediction request. |
| POST |
predict_batch_score_predict_batch_post /score/predict-batch |
Scores up to 500 player feature kits in one request. Each item uses the same feature shape as `POST /score/predict`. |
| POST |
predict_base_score_predict_base_post /score/predict-base |
Runs the base model family only and returns the base score set. |
| POST |
predict_score_predict_post /score/predict |
Scores a single player feature kit. `position`, `season`, and `league` are required. Missing optional numeric features are filled from model reference distributions. |
| database | ||
| GET |
get_players_basic_database_players_basic_get /database/players/basic |
Find player ids by name, position, league, season, or exact player id. |
| GET |
ratings_database_ratings_get /database/ratings |
Returns base and pro score rows from the ratings database. Filters are exact match unless noted. |
| GET |
role_cluster_summary_database_role_cluster_summary_get /database/role-cluster-summary |
Returns cluster-level labels, groups, and aggregate score profiles. |
| GET |
player_features_database_player_features_get /database/player-features |
Returns raw and engineered model feature rows from the player features database. |
| GET |
role_cluster_results_database_role_cluster_results_get /database/role-cluster-results |
Returns player-level role-cluster assignments and probability payloads. |
| player charts | ||
| GET |
timeline_player_charts_timeline__player_id__get /player-charts/timeline/{player_id} |
Season-by-season score timeline for one player. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
top_players_player_charts_top_players_get /player-charts/top-players |
Top player ranking chart by overall rating. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
score_scatter_player_charts_score_scatter_get /player-charts/score-scatter |
Scatter plot for two score dimensions. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
cluster_distribution_player_charts_cluster_distribution_get /player-charts/cluster-distribution |
Player counts per role cluster. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
radar_player_charts_radar__player_id__get /player-charts/radar/{player_id} |
Radar chart comparing a player against position average. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
cluster_profile_player_charts_cluster_profile__player_id__get /player-charts/cluster-profile/{player_id} |
Cluster membership probability chart for one player. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
league_scores_player_charts_league_scores_get /player-charts/league-scores |
Average score heatmap by league. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
compare_player_charts_compare_get /player-charts/compare |
Radar comparison for 2-5 players. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
score_distribution_player_charts_score_distribution_get /player-charts/score-distribution |
Score distribution box plot by position. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
cluster_heatmap_player_charts_cluster_heatmap_get /player-charts/cluster-heatmap |
Role-cluster mean z-score heatmap. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| model charts | ||
| GET |
leagues_charts_leagues_get /charts/leagues |
League distribution chart. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
positions_charts_positions_get /charts/positions |
Position distribution chart. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
overview_charts_overview_get /charts/overview |
Model dataset overview chart. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
base_models_charts_models_base_get /charts/models/base |
Base model metadata chart. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
feature_diff_charts_features_get /charts/features |
Feature usage and model coverage chart. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| GET |
pro_models_charts_models_pro_get /charts/models/pro |
Pro model metadata chart. Use the `format` query parameter where available to request `png`, `jpg`, `jpeg`, `webp`, `svg`, or interactive `html`. |
| report | ||
| GET |
player_report_report_get /report |
Returns a hosted HTML player report for the requested player. |
| GET |
player_report_data_report_data_get /report/data |
Returns the JSON payload used by the hosted player report page. |
| system | ||
| GET |
health_check_health_get /health |
Returns service availability. This endpoint does not require a request body. |
future football performance API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $9 / month | 60 / minute |
|
| ULTRA | $15 / month | 80 / minute |
|
| MEGA | $29 / month | 120 / minute |
|