The Touch resources provide access to individual statistical data related to contested ball touch events in a football match.
The Touches/Duels subresource allows you to access individual statistical data on the outcomes of contested 50/50 balls during in a football match. If lineupID is passed, it returns statistical data for a player in the match lineup that lineupID corresponds to.
If query parameters are passed to the resource, it returns the players in the match lineup who match the specified filters.
Response Parameters:
| Field | Type | Description |
|---|---|---|
| lineup | integer | The unique ID of the player in match lineup. |
| total_won | integer | Total number of 50/50 balls or tackles won. |
| total_lost | integer | Total number of 50/50 balls or tackles lost. |
| aerial_won | integer | Total number of 50/50 headed balls won. |
| aerial_lost | integer | Total number of 50/50 headed balls lost. |
| ground_won | integer | Total number of ground challenges (dribbles/tackles) won. |
| ground_lost | integer | Total number of ground challenges (dribbles/tackles) lost. |
The Touches/Locations subresource allows you to access individual statistical data on ball touches in a football match that occur in various sectors of the attacking half of the pitch. If lineupID is passed, it returns statistical data for a player in the match lineup that lineupID corresponds to.
If query parameters are passed to the resource, it returns the players in the match lineup who match the specified filters.
Response Parameters:
| Field | Type | Description |
|---|---|---|
| lineup | integer | The unique ID of the player in match lineup. |
| finalthird | integer | Total number of touches in opposing final third of the pitch. |
| oppbox | integer | Total number of touches within opposing penalty area. |
| oppsix | integer | Total number of touches within opposing goal (six-yard) area. |
The Touches/Totals subresource allows you to access cumulative individual statistical data on ball touches made by a player in a football match, including dribbles, which are defined as attempts to move past an opponent with the ball. If lineupID is passed, it returns statistical data for a player in the match lineup that lineupID corresponds to.
If query parameters are passed to the resource, it returns the players in the match lineup who match the specified filters.
Response Parameters:
| Field | Type | Description |
|---|---|---|
| lineup | integer | The unique ID of the player in match lineup. |
| dribble_overruns | integer | Total number of dribbling attempts where the ball rolls away. |
| dribble_success | integer | Total number of successful dribbles/take-ons past opponent. |
| dribble_failure | integer | Total number of unsuccessful dribbles/take-ons past opponent. |
| balltouch_success | integer | Total number of successful ball touches (controlled possession). |
| balltouch_failure | integer | Total number of unsuccessful ball touches (lost possession). |
| possession_loss | integer | Total number of lost possessions. |
| total | integer | Total number of ball touches. |