Overview

Returns a ranked list of the most valuable football players, including each player's market value, club, position, and selected season statistics. Use it to build market-value leaderboards or discover highly valued players, with optional pagination and position filters.

Inputs

page — number, optional. Page number for pagination. The verified request used 1.
main_position — select, required, default 0. Main-position filter. The verified request used "0" (all positions).
position — select, required, default alle. Position/orientation filter. The verified request used "alle" (all).

Response

A successful response has this shape:

data — object containing:
players — array of ranked player objects. Each item includes rank, name, playerId, profilePath, position, image, age, nationalities, club, clubId, clubPath, marketValue, matches, goals, ownGoals, assists, yellowCards, secondYellow, redCards, substitutionsOn, and substitutionsOff.
count — number of players returned; the verified response returned 25.
success — boolean.

The verified result was sampled and contained 25 players. The response included, among others, Ousmane Dembélé (rank: 17, marketValue: "€100.00m") and Jérémy Doku (rank: 48, marketValue: "€75.00m").

Auth & browser

Authentication is not required. The endpoint does not require a caller browser context or fetch mode.

Examples

Request

{
  "page": 1,
  "main_position": "0",
  "position": "alle"
}

Success response

{
  "data": {
    "players": [
      {
        "rank": 17,
        "name": "Ousmane Dembélé",
        "playerId": "288230",
        "profilePath": "/ousmane-dembele/profil/spieler/288230",
        "position": "Centre-Forward",
        "image": "https://img.a.transfermarkt.technology/portrait/small/288230-1684148641.jpg?lm=4711",
        "age": 29,
        "nationalities": ["France"],
        "club": "Paris Saint-Germain",
        "clubId": "583",
        "clubPath": "/fc-paris-saint-germain/startseite/verein/583",
        "marketValue": "€100.00m",
        "matches": 33,
        "goals": 18,
        "ownGoals": 0,
        "assists": 11,
        "yellowCards": 0,
        "secondYellow": 0,
        "redCards": 0,
        "substitutionsOn": 10,
        "substitutionsOff": 17
      },
      {
        "rank": 48,
        "name": "Jérémy Doku",
        "playerId": "486049",
        "profilePath": "/jeremy-doku/profil/spieler/486049",
        "position": "Left Winger",
        "image": "https://img.a.transfermarkt.technology/portrait/small/486049-1743670159.jpg?lm=4711",
        "age": 24,
        "nationalities": ["Belgium", "Ghana"],
        "club": "Manchester City",
        "clubId": "281",
        "clubPath": "/manchester-city/startseite/verein/281",
        "marketValue": "€75.00m",
        "matches": 27,
        "goals": 5,
        "ownGoals": 0,
        "assists": 8,
        "yellowCards": 0,
        "secondYellow": 0,
        "redCards": 0,
        "substitutionsOn": 10,
        "substitutionsOff": 10
      }
    ],
    "count": 25
  },
  "success": true
}

Notes

players is variable-length and is paginated with page.
rank values can repeat when players share the same ranking position.
Market values are returned as formatted strings such as "€100.00m", while IDs are string values.
Profile and club paths are relative URLs; image values are absolute URLs.
The example is a trimmed representation of the verified response; the live response may contain all 25 player records and may change over time.