Endpoint
Path parameters
Query parameters
Response (200)
This page is generated from the live API contract at
https://api.thestatsapi.com/llms.txt.Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Retrieve every shot in a match with xG, coordinates, body part, situation, derived flags, and non-penalty xG summary.
GET https://api.thestatsapi.com/api/football/matches/{match_id}/shotmap
| Name | Type | Required | Description |
|---|---|---|---|
match_id | string | Yes | Example: mt_838955483 |
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
player_id | string | No | Filter the shot list to a single player. Example: pl_29627593 |
{
"match_id": "mt_838955483",
"event": {
"id": "mt_838955483",
"home_team_id": "tm_0406",
"away_team_id": "tm_1002"
},
"data": [
{
"id": "sh_4812",
"player_id": "pl_29627593",
"player_name": "Mohamed Salah",
"team_id": "tm_0406",
"team_name": "Liverpool",
"x": 62.1,
"y": 88.3,
"minute": 24,
"result": "goal",
"expected_goals": 0.47,
"situation": "regular",
"body_part": "right-foot",
"goal_type": "regular",
"goal_mouth_location": "high-left",
"goal_mouth_coordinates": {
"x": 1.2,
"y": 0.8,
"z": 0.4
},
"block_coordinates": null,
"is_blocked_shot": false,
"blocked_by_player_id": "pl_08984824",
"goalkeeper": {
"id": "pl_29627593",
"name": "Manuel Neuer"
},
"is_goal": true,
"is_on_target": true,
"is_headed": false,
"is_outside_box": false,
"is_penalty": false
}
],
"np_xg_summary": {
"live": {
"home_team": 1.45,
"away_team": 0.82
},
"stored": {
"home_team": 1.45,
"away_team": 0.82
}
}
}
https://api.thestatsapi.com/llms.txt.