Fixtures

Player actions

GET/v2/fixtures/{id}/players/{playerId}/actionsPro + Business

Every on-ball action of one player in the fixture, with pitch coordinates: passes and crosses (start → end, completed or not, key pass, long ball), take-ons, defensive actions (tackles, interceptions, ball recoveries, clearances, blocks) and ball carries. Pro and Business plans.

Football, covered leagues; empty lists (200) for a player who did not play, before kick-off and in other sports. Coordinates are 0–100 in the player’s direction of attack (x 0 = his own goal line, 100 = the goal he attacks), the heatmap’s frame. successful counts against the lineups’ accurate / won statistics; null for ball carries. The source gives no time: the order is its own.

Parameters

pathrequired

our numeric id (positive integer)

playerId

pathrequired

our player id (e.g. from /lineups)

Response

data: PlayerActions
meta: playerId, count (all actions)
errors: 403 history_not_in_plan — the fixture kicked off before your plan’s history404 not_found — a fixture or player id that does not exist

Every /v2 call can also answer the common errors.

Try it →

$ curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/v2/fixtures/{id}/players/{playerId}/actions"

Example

{ "data": {
    "passes": [ { "type": "pass", "start": { "x": 27.7, "y": 96 }, "end": { "x": 23.3, "y": 94.8 }, "successful": true, "keyPass": false, "longBall": false },
                { "type": "cross", "start": { "x": 79.8, "y": 11.3 }, "end": { "x": 94.9, "y": 59.1 }, "successful": true, "keyPass": true, "longBall": true }, … ],
    "dribbles": [ { "type": "dribble", "start": { "x": 67.2, "y": 89.8 }, "end": null, "successful": true, "keyPass": null, "longBall": null }, … ],
    "defensive": [ { "type": "tackle", "start": { "x": 33.4, "y": 89.5 }, "end": null, "successful": false, "keyPass": null, "longBall": null }, … ],
    "ballCarries": [ { "type": "ballCarry", "start": { "x": 62.5, "y": 93.3 }, "end": { "x": 69.8, "y": 86.8 }, "successful": null, "keyPass": null, "longBall": null }, … ] },
  "meta": { "playerId": 1403061, "count": 72 } }