Touches

The Touch resources provide access to individual statistical data related to contested ball touch events in a football match.

Duels

GET /v1/stats/touches/duels/(lineupID)

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 uuid 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.
OPTIONS /v1/stats/touches/duels

Returns documentation of the Touches/Duels subresource.

Locations

GET /v1/stats/touches/locations/(lineupID)

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 uuid 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.
OPTIONS /v1/stats/touches/locations

Returns documentation of the Touches/Locations subresource.

Totals

GET /v1/stats/touches/totals/(lineupID)

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 uuid 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.
OPTIONS /v1/stats/touches/totals

Returns documentation of the Touches/Totals subresource.