Developers

Develop with the FutrixMetrics API

Build against a production football intelligence contract — not a loose demo surface. Validate in the playground, confirm the schema in ReDoc, then ship to production.

⚲ Base URLfootballperformanceapi.site
Integration Workflow

From playground to production

Prove the request in the playground, confirm the response contract in ReDoc, then copy the same endpoint and payload assumptions straight into your service layer.

01Step 01

Test first

Prove the request in the playground, confirm the response contract in ReDoc, then copy the endpoint and payload into your service layer.

02Step 02

Interactive testing

Exercise real endpoints, confirm authentication, validate payload shape, inspect response fields, and test edge cases before writing integration code.

03Step 03

Reference docs

Use the generated schema as the source of truth for parameters, response objects, validation rules, and the data types each module returns.

04Step 04

Move to production

Treat the playground as a contract rehearsal — check required fields, sample realistic inputs, inspect errors, and lock the payload before going live.

Core Outputs

What the API returns

The API is organized around outputs that stay useful after the first request: player scoring, role interpretation, and custom prediction for downstream products.

Player Rating API

Delivers normalized performance scores for dashboards, scouting shortlists, automated reports, and ranking logic.

RatingScoutingReports

Role Cluster Outputs

Role-cluster results and similarity signals — compare players by behavioral patterns, not just position labels.

ClusterRole FitComparison

Custom Prediction Module

Submit private or niche player feature sets to generate initial ratings and role interpretation when public records are incomplete.

PredictionPrivate DataCustom
Custom data integration

For academy players, smaller leagues, private files, trials, or proprietary training data — validate a representative payload first, then reuse that same request contract in your scoring workflows.

Get Started

Get an API key in 3 steps

Authentication is a single api_key passed with every request — no OAuth, no SDK required.

  1. 1Register & checkout to receive your api_key
  2. 2Add api_key to every request — query string or header
  3. 3Call any endpoint from the base URL
⚲ Get an API key
quickstart.sh GET
GET /database/ratings curl "https://footballperformanceapi.site/database/ratings?player_id=29481&api_key=YOUR_KEY"
Base free tier · upgrade for Pro models & higher quota
🔑
Authentication

Pass api_key as a ?api_key= query param or an X-API-Key header.

Models

Base models are free; Pro models unlock on paid plans.

Rate limits

Requests/hour and RPM follow your checkout plan.

API Reference

Endpoints by module

Six modules cover data, scoring, charts, reports, and the no-code platform.

01
DatabaseDeploy existing player data to your product
GET
Find PlayerSearch players by name or team; returns player_id
GET
Get RatingsPre-computed ML scores & sub-dimension ratings
GET
Get Feature DataPer-90-minute engineered stats
GET
Get Role ClusterPlaying role assignment with confidence
GET
Get Role DescriptionsText descriptions of role meanings
02
ScoreScore your own players with ML models
POST
Base Model ScoreQuick ML scoring with the Base model
POST
Pro Model ScoreProduction-grade scoring, higher accuracy
POST
Batch ScoreSubmit an entire squad in one request
GET
Model StatusLive models & current API latency
03
Player ChartsGenerate visual analysis charts for any player
GET
Radar ChartHexagonal radar of player attributes
GET
Compare PlayersSide-by-side attribute comparison
GET
Top RankingsDistribution chart of top performers
GET
Scatter PlotPlayer vs peers by score
GET
Cluster ProfileRole membership & nearest neighbors
04
Model ChartsUnderstand model accuracy and data coverage
GET
Dataset OverviewPlayers indexed, leagues, data freshness
GET
Model PerformanceAccuracy & ROC-AUC comparison
GET
Position BreakdownPlayer distribution across positions
GET
Feature ImportancePer-90 stats impact on scores
05
ReportGenerate full player analysis reports
GET
HTML ReportComplete shareable visual report
GET
Structured Report DataJSON payload for custom use
06
PlatformInteractive visual interface — no code needed
GET
Player ExplorerVisual search & browsing
POST
Report BuilderCustomize & generate a report
POST
Widget ConfigConfigure an embedded widget
✦ Developers

Start from the live playground

Open the playground, test a realistic request, then use the API document to lock down endpoint behavior before production work.