Team of the Week (TOTW) - beta
Last updated
Was this helpful?
Last updated
Was this helpful?
Our Team of the Week (TOTW) engine automatically picks the top 11 performers of every round using Sportmonks’ proprietary Player Rating model. No editorial bias—just data‑driven, repeatable selection.
Action
API request
Get all available TOTWS
Get the TOTW for a specific round
Get the latest TOTW for a specific league
All endpoints require your standard api_token query parameter.
Enrich your response by adding includes to your response with ?include=.
Include
Add
player
Player objects (id, name, nationality, height, etc.)
team
Team objects (id, name, logo, etc.)
round
Round metadata (name, start/end dates, fixtures, etc.)
Round‑based competitions only. Knock‑out stages and playoff matches are not supported.
Player ratings are updated once all fixtures in a round are finished; a TOTW becomes available immediately thereafter.
Check the league
Our TOTW logic has been carefully designed to reflect each player’s impact and position on the pitch:
Lineup roles We begin by collecting player ratings from every lineup and determine each player's specific role based on their actual formation—for example, distinguishing between a centre-back and a left-back.
Formation matching For several commonly used formations, we then select the highest-rated player for each role, while ensuring no more than 3 players from the same team are chosen. This keeps the lineup competitive and diverse.
Best formation We calculate the average rating of each possible TOTW lineup, and the formation with the highest score becomes our Team of the Week for that round.
We 💚 feedback! Email support@sportmonks.com with:
Full request URL including query string
The round or league ID affected
What you observed vs. what you expected
Any additional screenshots or logs
The more context you provide, the faster we can assist.
Date (UTC)
Version
Notes
2025‑05‑02
0.9.0‑beta
Initial public beta release.