Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Team of the week

GET

/v2/leagues/{id}/team-of-the-week

Pro and up

View as MarkdownTry in Playground →

The team of the week for one round or week, set out as a line-up of the top-rated players: formation, then each player with their club, position, the rating that won them the spot and the match they earned it in.

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.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

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

period

query

a period id listed by /v2/leagues/{id}/team-of-the-week/periods; defaults to the latest period

Response

meta
season, period (the period actually shown), count (players in the team)
errors
403 history_not_in_plan — your plan’s history window begins after this season ended404 no_data — no team of the week is available from our data source for this league and season so far404 not_found — the period belongs to a different season, or the season to a different 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/leagues/{id}/team-of-the-week?season=…"
Example
{ "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 } }