Team of the week

What Sportmonks provides

Sportmonks’ TOTW engine selects the top 11 performers from every completed round using a proprietary player rating model. The selection process works as follows:

1. Player ratings are collected from every lineup in the round, with each player assigned a positional role based on the actual formation they played in (for example, a centre-back and a left-back are treated as distinct roles).
2. For each commonly used formation, the engine selects the highest-rated player at each role, with a cap of three players per team to keep selections competitive and varied.
3. The engine then calculates the average rating for each possible TOTW lineup and selects the formation with the highest overall score as the Team of the Week for that round.

The result is published as soon as all fixtures in a round are complete. Each TOTW response includes the selected players, their positions in the chosen formation, and their ratings for that round.

Note: TOTW is currently in public beta. Coverage is limited to round-based competitions; knockout stages and playoff matches are not supported.

Endpoints

There are three TOTW endpoints:

GET All Available TOTWs returns every TOTW generated across all rounds within your subscription. Use this to browse historical selections or build an archive view.

GET https://api.sportmonks.com/v3/football/team-of-the-week?api_token=YOUR_TOKEN

GET TOTW by Round ID returns the Team of the Week for a specific round. Use this to display the TOTW alongside your matchday or round coverage.

GET https://api.sportmonks.com/v3/football/team-of-the-week/rounds/{round_id}?api_token=YOUR_TOKEN

GET Latest TOTW by League ID returns the most recently published TOTW for a given league. Use this for an always-current TOTW widget that updates each round without needing to track round IDs.

GET https://api.sportmonks.com/v3/football/team-of-the-week/leagues/{league_id}/latest?api_token=YOUR_TOKEN

Includes

All three TOTW endpoints support the following includes:

– player — enriches each selected player with full profile data (name, nationality, height, image, etc.)
– team — adds team metadata for each selected player (name, logo, etc.)
– round — appends round metadata to the response, including the round name, start and end dates, and associated fixtures

Example with includes:

GET https://api.sportmonks.com/v3/football/team-of-the-week/leagues/{league_id}/latest?api_token=YOUR_TOKEN&include=player;team;round

What you can build with TOTW data

– Weekly TOTW features — publish a round-by-round best XI graphic or interactive lineup display after each matchday
– Player of the Round highlights — surface individual standout performers from within the TOTW selection
– Season TOTW archives — retrieve all historical TOTWs for a league and display which players appeared most frequently
– Fantasy football integrations — use TOTW selections as a data signal for player form and round performance.
– Editorial automation — generate TOTW content automatically from the API response, without manual editorial selection each week
– Cross-league TOTW comparisons — query the latest TOTW for multiple leagues and compare top performers across competitions

Availability

TOTW data is included in all Starter, Growth, Pro, and Enterprise plans. Coverage is limited to leagues that use a round-based format; the specific leagues supported are listed in the Sportmonks TOTW coverage sheet, linked in the Football API v3 documentation. As TOTW is currently in public beta, coverage may expand over time.

You can explore and test the TOTW endpoints using the Sportmonks Postman collection or the API tester in MySportmonks.

Try it free ; all paid plans include a 14-day free trial, and the forever-free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.