Data API · Advanced parameters
Advanced match parameters
GET/api/v1/datas/advanced-parameters/{id}
Returns calculated attacking, possession and referee metrics for both teams.
Bearer authentication required · service: data_apiReference only — this page never sends API requests or exposes token controls.
Response formats
When format is listed below, use json for the response documented here, or csv and xml for downloads. JSON uses camelCase by default; set case=snake_case when supported for legacy key names. Nested response fields use dot notation; [] denotes an array item and {key} a dynamic object key.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | Required | Match ID Minimum 1. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | Required | Response format. Allowed: json, csv, xml. |
| case | string | Optional | JSON response key style. Default: camelCase. Allowed: camelCase, snake_case. |
Response attributes
| Attribute | Type | Description |
|---|---|---|
| matchId | integer | Match ID. |
| homeTeam | integer | Home team ID. |
| awayTeam | integer | Away team ID. |
| referee | object | Referee severity metrics. |
| referee.rsi | number | Referee severity index. |
| referee.cardRate | number | Cards per ten fouls. |
| home | object | Home team metrics. |
| home.teamId | integer | Home team ID. |
| home.squadId | integer | Home squad ID. |
| home.teamName | string|null | Home team name. |
| home.teamAggression | number | Fouls and offsides per match minute. |
| home.teamDiscipline | number | Fouls per card. |
| home.raw | object | Raw attacking metrics. |
| home.raw.goals | number | Goals. |
| home.raw.totalShots | number | Total shots. |
| home.raw.shotsOnTarget | number | Shots on target. |
| home.raw.ballPossessionPct | number | Ball-possession percentage. |
| home.raw.totalPossessions | number | Total possessions. |
| home.raw.attacksTotal | number | Total attacks. |
| home.raw.attacksWithShot | number | Attacks ending with a shot. |
| home.raw.possessionsWithShotPct | number | Percentage of possessions ending with a shot. |
| home.metrics | object | Calculated attacking metrics. |
| home.metrics.shotAccuracy | object | Calculated shotAccuracy metric. |
| home.metrics.shotAccuracy.numerator | number | Metric numerator. |
| home.metrics.shotAccuracy.denominator | number | Metric denominator. |
| home.metrics.shotAccuracy.ratio | number | Calculated ratio. |
| home.metrics.shotConversionRate | object | Calculated shotConversionRate metric. |
| home.metrics.shotConversionRate.numerator | number | Metric numerator. |
| home.metrics.shotConversionRate.denominator | number | Metric denominator. |
| home.metrics.shotConversionRate.ratio | number | Calculated ratio. |
| home.metrics.onTargetConversion | object | Calculated onTargetConversion metric. |
| home.metrics.onTargetConversion.numerator | number | Metric numerator. |
| home.metrics.onTargetConversion.denominator | number | Metric denominator. |
| home.metrics.onTargetConversion.ratio | number | Calculated ratio. |
| home.metrics.possessionEffectiveness | object | Calculated possessionEffectiveness metric. |
| home.metrics.possessionEffectiveness.numerator | number | Metric numerator. |
| home.metrics.possessionEffectiveness.denominator | number | Metric denominator. |
| home.metrics.possessionEffectiveness.ratio | number | Calculated ratio. |
| home.metrics.shotsPerPossession | object | Calculated shotsPerPossession metric. |
| home.metrics.shotsPerPossession.numerator | number | Metric numerator. |
| home.metrics.shotsPerPossession.denominator | number | Metric denominator. |
| home.metrics.shotsPerPossession.ratio | number | Calculated ratio. |
| home.metrics.teamIntensityIndex | object | Calculated teamIntensityIndex metric. |
| home.metrics.teamIntensityIndex.numerator | number | Metric numerator. |
| home.metrics.teamIntensityIndex.denominator | number | Metric denominator. |
| home.metrics.teamIntensityIndex.ratio | number | Calculated ratio. |
| home.metrics.controlIndex | object | Calculated controlIndex metric. |
| home.metrics.controlIndex.numerator | number | Metric numerator. |
| home.metrics.controlIndex.denominator | number | Metric denominator. |
| home.metrics.controlIndex.ratio | number | Calculated ratio. |
| home.metrics.chaosIndex | object | Calculated chaosIndex metric. |
| home.metrics.chaosIndex.numerator | number | Metric numerator. |
| home.metrics.chaosIndex.denominator | number | Metric denominator. |
| home.metrics.chaosIndex.ratio | number | Calculated ratio. |
| home.metrics.passIntensity | object | Calculated passIntensity metric. |
| home.metrics.passIntensity.numerator | number | Metric numerator. |
| home.metrics.passIntensity.denominator | number | Metric denominator. |
| home.metrics.passIntensity.ratio | number | Calculated ratio. |
| home.metrics.tempoIndex | object | Calculated tempoIndex metric. |
| home.metrics.tempoIndex.numerator | number | Metric numerator. |
| home.metrics.tempoIndex.denominator | number | Metric denominator. |
| home.metrics.tempoIndex.ratio | number | Calculated ratio. |
| home.metrics.directnessIndex | object | Calculated directnessIndex metric. |
| home.metrics.directnessIndex.numerator | number | Metric numerator. |
| home.metrics.directnessIndex.denominator | number | Metric denominator. |
| home.metrics.directnessIndex.ratio | number | Calculated ratio. |
| away | object | Away team metrics. |
| away.teamId | integer | Away team ID. |
| away.squadId | integer | Away squad ID. |
| away.teamName | string|null | Away team name. |
| away.teamAggression | number | Fouls and offsides per match minute. |
| away.teamDiscipline | number | Fouls per card. |
| away.raw | object | Raw attacking metrics. |
| away.raw.goals | number | Goals. |
| away.raw.totalShots | number | Total shots. |
| away.raw.shotsOnTarget | number | Shots on target. |
| away.raw.ballPossessionPct | number | Ball-possession percentage. |
| away.raw.totalPossessions | number | Total possessions. |
| away.raw.attacksTotal | number | Total attacks. |
| away.raw.attacksWithShot | number | Attacks ending with a shot. |
| away.raw.possessionsWithShotPct | number | Percentage of possessions ending with a shot. |
| away.metrics | object | Calculated attacking metrics. |
| away.metrics.shotAccuracy | object | Calculated shotAccuracy metric. |
| away.metrics.shotAccuracy.numerator | number | Metric numerator. |
| away.metrics.shotAccuracy.denominator | number | Metric denominator. |
| away.metrics.shotAccuracy.ratio | number | Calculated ratio. |
| away.metrics.shotConversionRate | object | Calculated shotConversionRate metric. |
| away.metrics.shotConversionRate.numerator | number | Metric numerator. |
| away.metrics.shotConversionRate.denominator | number | Metric denominator. |
| away.metrics.shotConversionRate.ratio | number | Calculated ratio. |
| away.metrics.onTargetConversion | object | Calculated onTargetConversion metric. |
| away.metrics.onTargetConversion.numerator | number | Metric numerator. |
| away.metrics.onTargetConversion.denominator | number | Metric denominator. |
| away.metrics.onTargetConversion.ratio | number | Calculated ratio. |
| away.metrics.possessionEffectiveness | object | Calculated possessionEffectiveness metric. |
| away.metrics.possessionEffectiveness.numerator | number | Metric numerator. |
| away.metrics.possessionEffectiveness.denominator | number | Metric denominator. |
| away.metrics.possessionEffectiveness.ratio | number | Calculated ratio. |
| away.metrics.shotsPerPossession | object | Calculated shotsPerPossession metric. |
| away.metrics.shotsPerPossession.numerator | number | Metric numerator. |
| away.metrics.shotsPerPossession.denominator | number | Metric denominator. |
| away.metrics.shotsPerPossession.ratio | number | Calculated ratio. |
| away.metrics.teamIntensityIndex | object | Calculated teamIntensityIndex metric. |
| away.metrics.teamIntensityIndex.numerator | number | Metric numerator. |
| away.metrics.teamIntensityIndex.denominator | number | Metric denominator. |
| away.metrics.teamIntensityIndex.ratio | number | Calculated ratio. |
| away.metrics.controlIndex | object | Calculated controlIndex metric. |
| away.metrics.controlIndex.numerator | number | Metric numerator. |
| away.metrics.controlIndex.denominator | number | Metric denominator. |
| away.metrics.controlIndex.ratio | number | Calculated ratio. |
| away.metrics.chaosIndex | object | Calculated chaosIndex metric. |
| away.metrics.chaosIndex.numerator | number | Metric numerator. |
| away.metrics.chaosIndex.denominator | number | Metric denominator. |
| away.metrics.chaosIndex.ratio | number | Calculated ratio. |
| away.metrics.passIntensity | object | Calculated passIntensity metric. |
| away.metrics.passIntensity.numerator | number | Metric numerator. |
| away.metrics.passIntensity.denominator | number | Metric denominator. |
| away.metrics.passIntensity.ratio | number | Calculated ratio. |
| away.metrics.tempoIndex | object | Calculated tempoIndex metric. |
| away.metrics.tempoIndex.numerator | number | Metric numerator. |
| away.metrics.tempoIndex.denominator | number | Metric denominator. |
| away.metrics.tempoIndex.ratio | number | Calculated ratio. |
| away.metrics.directnessIndex | object | Calculated directnessIndex metric. |
| away.metrics.directnessIndex.numerator | number | Metric numerator. |
| away.metrics.directnessIndex.denominator | number | Metric denominator. |
| away.metrics.directnessIndex.ratio | number | Calculated ratio. |