Team of the week

GET

https://api.datasportsapi.com/v2/leagues/{id}/team-of-the-week

Plan: Pro + Business
Auth: Bearer dsa_live_…
Parameters: 2 required · 1 optional
Returns: TeamOfTheWeek

The team of the week for a single round or week, laid out as a line-up of the top-rated players: the formation, then each player with his club, his position, the rating that won him the spot and the match in which he earned it.

Plan access

Requires a Pro or Business plan; every other plan receives 403 endpoint_not_in_plan.

Worth knowing

Football teams have 11 players, with order 1 being the goalkeeper; NBA teams have 5 players in formation "2-3". Ratings are our data source’s match ratings on a 0–10 scale. Once published, a team of the week is final.

01Parameters

Name	In	Required	Description
`id`	path	Required	league id issued by DataSportsAPI, a positive integer
`season`	query	Required	season id, as listed by /v2/leagues/{id}/seasons
`period`	query	Optional	a period id listed by /v2/leagues/{id}/team-of-the-week/periods; defaults to the latest period

idpathRequired
league id issued by DataSportsAPI, a positive integer
seasonqueryRequired
season id, as listed by /v2/leagues/{id}/seasons
periodqueryOptional
a period id listed by /v2/leagues/{id}/team-of-the-week/periods; defaults to the latest period

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/leagues/{id}/team-of-the-week?season=…"

03Response

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

data: TeamOfTheWeek
meta: season, period (the period actually shown), count (players in the team)

ObjectsTeamOfTheWeek

Example response

7 lines

{ "data": { "period": { "id": 812604, "kind": "round", "sequence": 9, "round": 9, "roundName": "9", … },
    "formation": "3-4-3",
    "players": [
      { "order": 1, "player": { "id": 994363, "name": "Bart Verbruggen", "shortName": "B. Verbruggen", … },
        "team": { "id": 30, "name": "Brighton & Hove Albion", … }, "position": "goalkeeper", "rating": 9.6, "fixtureId": 701188 },
      { "order": 2, "player": { "name": "Jan Paul van Hecke", … }, "position": "defender", "rating": 9.8, … }, … ] },
  "meta": { "season": 200386, "period": 812604, "count": 11 } }

04Errors

403history_not_in_plan
your plan’s history window begins after this season ended
404no_data
no team of the week is available from our data source for this league and season so far
404not_found
the period belongs to a different season, or the season to a different league

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code