get_shot_map
Read-only
Use for a shot map: a club's shots (or, with against, the shots it conceded), a player's, or one match's, for a season (default: the latest). Returns totals and zones (six-yard box, penalty area, outside the box, penalties) with goals, shots on target, xG and conversion, and every located shot with its x/y, end point, outcome and xG. Costs 10 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | Club id, abbreviation or name. | |
| league | No | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. | |
| player | No | Player id (search_players). | |
| season | No | Season by the year it starts (default: the latest). | |
| against | No | With team: the shots it conceded. | |
| game_id | No | One match instead of a season. | |
| include_shots | No | false = totals and zones only. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| shots | No | ||
| zones | Yes | ||
| season | Yes | ||
| totals | Yes | ||
| shots_note | No | ||
| shots_total | Yes | ||
| unlocated_shots | No |