Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Teams

Goal distribution

GET

/v2/teams/{id}/goal-distribution

All plans

View as MarkdownTry in Playground →

Football: shows at which stage of a match a team scores and concedes across one league season, counting goals in 15-minute bands for all matches, home matches and away matches.

The list has three entries (overall, home, away), each split into six bands from 1–15 to 76–90; goals in added time are counted in the band they extend. Empty if the source has no distribution.

Parameters

id

pathrequired

DataSportsAPI team id, a positive integer

league

queryrequired

league id — for example, the league of one of the team’s fixtures

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

Response

meta
league, season, count
errors
403 history_not_in_plan — the season finished before your plan’s history window begins404 not_found — the season id does not belong to this league

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/goal-distribution?league=…&season=…"
Example
{ "data": [ { "scope": "overall", "fixtureCount": 9, "scored": 12, "conceded": 15,
      "bands": [ { "fromMinute": 1, "toMinute": 15, "scored": 3, "conceded": 2 }, { "fromMinute": 16, "toMinute": 30, "scored": 0, "conceded": 0 }, … ] },
    { "scope": "home", … }, { "scope": "away", … } ],
  "meta": { "league": 200001, "season": 200386, "count": 3 } }