Endpoint Playground

Try the SofaScore team of the week API

Returns one team of the week: the formation and the selected players with their SofaScore rating, team and, for round and weekly selections, the match the rating was earned in. Get the `period` id from sofascore-team-of-the-week-periods; a period that does not belong to the given competition season is rejected with 400.

What a live request returned

14 Oct 2026: 11 players; 6 fields had a value in every checked item.

Observed request: GET /sofascore/team-of-the-week?id=17&period=29321&season=96668
Fields with a value in every checked item: order, rating, player, jersey_number, team, event

Sample value profiles: order: 1 to 11, median 6; rating: 8 to 9.8, median 8.2; jersey_number: 1 to 44, median 10.

Request: GET /sofascore/team-of-the-week
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.57 s
Monitored request: GET /sofascore/team-of-the-week?id=17&period=29321&season=96668

SofaScore team of the week API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/team-of-the-week?id=17&season=96668&period=29321' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	17	Numeric SofaScore unique-tournament (competition) id
season	string	Yes	96668	Numeric SofaScore season id
period	string	Yes	29321	Numeric period id from sofascore-team-of-the-week-periods

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "period": {
      "id": 29321,
      "type": "round",
      "name": "round",
      "sequence": 5,
      "round": 5,
      "round_name": "5"
    },
    "formation": "3-2-4-1",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/team-of-the-week/29321",
    "fetched_at": "2026-10-07T14:00:00Z",
    "players": [
      {
        "order": 1,
        "rating": 8.6,
        "player": {
          "id": 964753,
          "name": "Senne Lammens",
          "slug": "senne-lammens",
          "position": "G"
        },
        "jersey_number": "1",
        "team": {
          "id": 35,
          "name": "Manchester United",
          "slug": "manchester-united"
        },
        "event": {
          "id": 16363652,
          "slug": "fulham-manchester-united",
          "status": {
            "code": 100,
            "description": "Ended",
            "type": "finished"
          },
          "tournament": {
            "id": 1,
            "name": "Premier League",
            "unique_tournament_id": 17
          },
          "home_team": {
            "id": 43,
            "name": "Fulham"
          },
          "away_team": {
            "id": 35,
            "name": "Manchester United"
          }
        }
      }
    ]
  }
}

More SofaScore endpoints

SofaScore categories for a sport SofaScore competitions in a category SofaScore league draft SofaScore league draft picks SofaScore esports game detail SofaScore event detail SofaScore event at-bat pitches SofaScore event at-bats SofaScore event average positions SofaScore event baseball top performers SofaScore event best players SofaScore event commentary All 109 SofaScore endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestsofascore.teamOfTheWeekResponseDocSofaScore

GET /sofascore/team-of-the-week

SofaScore team of the week

Response behavior

- `period` echoes the period's metadata (`type` is `round`, `timespan` or `season`). A period id that is not in the competition season's own period list is rejected with 400: SofaScore serves period ids globally, so an id from another competition would otherwise return that other competition's team. - `formation` is SofaScore's formation string, for example `3-2-4-1` for football or `2-3` for the NBA. `players` are in selection `order`. - `rating` is SofaScore's numeric rating (omitted if SofaScore sends none). `event` is the match behind the selection and is present for round and weekly periods; season-level selections have no `event`. - This route makes two upstream requests (the period list, then the team). Example response (shortened): ```json { "code": 200, "msg": "OK", "data": { "tournament_id": 17, "season_id": 96668, "period": { "id": 29321, "type": "round", "name": "round", "sequence": 5, "round": 5, "round_name": "5" }, "formation": "3-2-4-1", "count": 1, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/team-of-the-week/29321", "fetched_at": "2026-10-07T14:00:00Z", "players": [ { "order": 1, "rating": 8.6, "player": { "id": 964753, "name": "Senne Lammens", "slug": "senne-lammens", "position": "G" }, "jersey_number": "1", "team": { "id": 35, "name": "Manchester United", "slug": "manchester-united" }, "event": { "id": 16363652, "slug": "fulham-manchester-united", "status": { "code": 100, "description": "Ended", "type": "finished" }, "tournament": { "id": 1, "name": "Premier League", "unique_tournament_id": 17 }, "home_team": { "id": 43, "name": "Fulham" }, "away_team": { "id": 35, "name": "Manchester United" } } } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Numeric SofaScore unique-tournament (competition) idseason

requiredstring

Numeric SofaScore season idperiod

requiredstring

Numeric period id from sofascore-team-of-the-week-periods

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "period": {
      "id": 29321,
      "type": "round",
      "name": "round",
      "sequence": 5,
      "round": 5,
      "round_name": "5"
    },
    "formation": "3-2-4-1",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/team-of-the-week/29321",
    "fetched_at": "2026-10-07T14:00:00Z",
    "players": [
      {
        "order": 1,
        "rating": 8.6,
        "player": {
          "id": 964753,
          "name": "Senne Lammens",
          "slug": "senne-lammens",
          "position": "G"
        },
        "jersey_number": "1",
        "team": {
          "id": 35,
          "name": "Manchester United",
          "slug": "manchester-united"
        },
        "event": {
          "id": 16363652,
          "slug": "fulham-manchester-united",
          "status": {
            "code": 100,
            "description": "Ended",
            "type": "finished"
          },
          "tournament": {
            "id": 1,
            "name": "Premier League",
            "unique_tournament_id": 17
          },
          "home_team": {
            "id": 43,
            "name": "Fulham"
          },
          "away_team": {
            "id": 35,
            "name": "Manchester United"
          }
        }
      }
    ]
  }
}

Try the SofaScore team of the week API

What a live request returned

14 Oct 2026: 11 players; 6 fields had a value in every checked item.

Observed request: GET /sofascore/team-of-the-week?id=17&period=29321&season=96668
Fields with a value in every checked item: order, rating, player, jersey_number, team, event

Sample value profiles: order: 1 to 11, median 6; rating: 8 to 9.8, median 8.2; jersey_number: 1 to 44, median 10.

Request: GET /sofascore/team-of-the-week
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.57 s
Monitored request: GET /sofascore/team-of-the-week?id=17&period=29321&season=96668

SofaScore team of the week API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/team-of-the-week?id=17&season=96668&period=29321' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	17	Numeric SofaScore unique-tournament (competition) id
season	string	Yes	96668	Numeric SofaScore season id
period	string	Yes	29321	Numeric period id from sofascore-team-of-the-week-periods

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "period": {
      "id": 29321,
      "type": "round",
      "name": "round",
      "sequence": 5,
      "round": 5,
      "round_name": "5"
    },
    "formation": "3-2-4-1",
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/team-of-the-week/29321",
    "fetched_at": "2026-10-07T14:00:00Z",
    "players": [
      {
        "order": 1,
        "rating": 8.6,
        "player": {
          "id": 964753,
          "name": "Senne Lammens",
          "slug": "senne-lammens",
          "position": "G"
        },
        "jersey_number": "1",
        "team": {
          "id": 35,
          "name": "Manchester United",
          "slug": "manchester-united"
        },
        "event": {
          "id": 16363652,
          "slug": "fulham-manchester-united",
          "status": {
            "code": 100,
            "description": "Ended",
            "type": "finished"
          },
          "tournament": {
            "id": 1,
            "name": "Premier League",
            "unique_tournament_id": 17
          },
          "home_team": {
            "id": 43,
            "name": "Fulham"
          },
          "away_team": {
            "id": 35,
            "name": "Manchester United"
          }
        }
      }
    ]
  }
}

SofaScore team of the week

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "tournament_id": 17, "season_id": 96668, "period": { "id": 29321, "type": "round", "name": "round", "sequence": 5, "round": 5, "round_name": "5" }, "formation": "3-2-4-1", "count": 1, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/team-of-the-week/29321", "fetched_at": "2026-10-07T14:00:00Z", "players": [ { "order": 1, "rating": 8.6, "player": { "id": 964753, "name": "Senne Lammens", "slug": "senne-lammens", "position": "G" }, "jersey_number": "1", "team": { "id": 35, "name": "Manchester United", "slug": "manchester-united" }, "event": { "id": 16363652, "slug": "fulham-manchester-united", "status": { "code": 100, "description": "Ended", "type": "finished" }, "tournament": { "id": 1, "name": "Premier League", "unique_tournament_id": 17 }, "home_team": { "id": 43, "name": "Fulham" }, "away_team": { "id": 35, "name": "Manchester United" } } } ] } }