Skip to content
datasportsAPI

TeamsGoal distribution

Documentation

/

Type to filter the docs by title or path.

TeamsEndpoint 36 of 116

Goal distribution

GET

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

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
3 required · 0 optional
Returns
GoalDistribution[]
Try 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.

Worth knowing

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.

01Parameters

  • idpathRequired

    DataSportsAPI team id, a positive integer

  • leaguequeryRequired

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

  • seasonqueryRequired

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

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/goal-distribution?league=…&season=…"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
GoalDistribution[]
meta
league, season, count
ObjectsGoalDistribution
Example response
{ "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 } }

04Errors

  • 403history_not_in_plan

    the season finished before your plan’s history window begins

  • 404not_found

    the season id does not belong to this league

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code