The Passes resources provide access to individual statistical data related to passing actions in a football match.
The Passes/Directions subresource allows you to access individual statistical data on passes made in a given direction during in a football match. We assume that a team will move from its own goal toward their its opponent’s goal. Some passes are played forward and toward a flank; in these situations two fields would be updated.
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. |
| pass_forward | integer | Total number of passes played toward opponent’s goal. |
| pass_backward | integer | Total number of passes played toward own goal. |
| pass_left | integer | Total number of passes played toward left touch line. |
| pass_right | integer | Total number of passes played toward right touch line. |
The Passes/Lengths subresource allows you to access individual statistical data on the performance of passing actions of varying lengths 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. |
| short_success | integer | Total number of short passes that are successfully controlled by a teammate. |
| short_failure | integer | Total number of short passes that are unsuccessfully controlled by a teammate. |
| long_success | integer | Total number of long passes that are successfully controlled by a teammate. |
| long_failure | integer | Total number of long passes that are successfully controlled by a teammate. |
| flickon_success | integer | Total number of flick-on passes that are successfully controlled by a teammate. |
| flickon_failure | integer | Total number of flick-on passes that are unsuccessfully controlled by a teammate. |
The Passes/Locations subresource allows you to access individual statistical data on successful and unsuccessful passes in a football match initiated from various sectors 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. |
| ownhalf_success | integer | Total number of passes from own half that are successfully controlled by a teammate. |
| ownhalf_failure | integer | Total number of passes from own half that are unsuccessfully controlled by a teammate. |
| opphalf_success | integer | Total number of passes from opposition half that are successfully controlled by a teammate. |
| opphalf_failure | integer | Total number of passes from opposition half that are unsuccessfully controlled by a teammate. |
| defthird_success | integer | Total number of passes from defensive third that are successfully controlled by a teammate. |
| defthird_failure | integer | Total number of passes from defensive third that are unsuccessfully controlled by a teammate. |
| midthird_success | integer | Total number of passes from middle third that are successfully controlled by a teammate. |
| midthird_failure | integer | Total number of passes from middle third that are unsuccessfully controlled by a teammate. |
| finthird_success | integer | Total number of passes from final third that are successfully controlled by a teammate. |
| finthird_failure | integer | Total number of passes from final third that are unsuccessfully controlled by a teammate. |
The Passes/Totals subresource allows you to access individual statistical data on cumulative passing actions made by a player 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_success | integer | Total number of passes that are successfully controlled by a teammate. |
| total_failure | integer | Total number of passes that are unsuccessfully controlled by a teammate. |
| total_no_cc_success | integer | Total number of successful passes, excluding crosses that result from corners. |
| total_no_cc_failure | integer | Total number of unsuccessful passes, excluding crosses that result from corners. |
| longball_success | integer | Total number of successful long passes (30 meters or more). |
| longball_failure | integer | Total number of unsuccessful long passes (30 meters or more). |
| layoffs_success | integer | Total number of successful lay-off passes. |
| layoffs_failure | integer | Total number of unsuccessful lay-off passes. |
| throughballs | integer | Total number of passes between a group of defenders toward a teammate. |
| keypasses | integer | Total number of passes deemed “key” to buildup or team strategy. |