Overview

Returns detailed biographical, professional, market-value, and current-club information for a football player. Use it when you need a player profile rather than transfer history, match performance, injuries, or market-value history.

Inputs

id (string, optional): Transfermarkt player identifier. The endpoint definition defaults to 68290 (Neymar).

Response

The successful response is an envelope with success, message, and data fields. data contains:

Identity: id, name, shortName, artistName, displayName.
lifeDates: age, date of birth/death, and flags indicating unknown dates.
birthPlaceDetails: birthplace, country ID, additional location information, and gender.
nationalityDetails: passport name and nationality IDs.
attributes: height, preferred foot, positions, contract dates, consultant agency, outfitter, and related position/agency objects.
preferences, nominees, and participations.
Profile and image data: relativeUrl, portraitUrl, and portraitUrlSource.
marketValueDetails: current, previous, delta, and highest market values, including numeric values, currency, compact display values, determination dates, and change information.
clubAssignments: player/club IDs, shirt number, captain status, assignment type, debut, and start date.
lastClubId.

Auth & browser

Authentication is not required. The endpoint uses the configured request URL directly and does not require a caller browser context.

Examples

Request

{
  "id": "68290"
}

Success response

Verified using player ID 68290:

{
  "success": true,
  "message": "OK",
  "data": {
    "id": "68290",
    "name": "Neymar",
    "displayName": "Neymar da Silva Santos Júnior",
    "lifeDates": {
      "age": 34,
      "dateOfBirth": "1992-02-05",
      "dateOfDeath": null
    },
    "attributes": {
      "height": 1.75,
      "positionGroup": "MIDFIELDER",
      "positionGroupName": "Midfielder",
      "contractUntil": "2026-12-31",
      "preferredFoot": {
        "id": 2,
        "name": "right"
      },
      "position": {
        "id": 10,
        "name": "Attacking Midfield",
        "shortName": "AM",
        "category": "Midfielder"
      }
    },
    "relativeUrl": "/neymar/profil/spieler/68290",
    "portraitUrl": "https://img.a.transfermarkt.technology/portrait/big/68290-1692601435.jpg",
    "marketValueDetails": {
      "current": {
        "value": 8000000,
        "currency": "EUR",
        "compact": {
          "prefix": "€",
          "content": "8.00",
          "suffix": "M"
        },
        "determined": "2026-05-26"
      },
      "previous": {
        "value": 10000000,
        "currency": "EUR"
      },
      "delta": {
        "value": "-2.000.000 €",
        "percentage": "-20,00 %",
        "type": "DECREASED"
      },
      "highest": {
        "value": 180000000,
        "currency": "EUR"
      }
    },
    "clubAssignments": [
      {
        "playerId": "68290",
        "clubId": "221",
        "shirtNumber": 10,
        "isCaptain": true,
        "type": "current"
      }
    ]
  }
}

The verified response also included empty nominees and participations arrays, a lastClubId of 0, and additional date, nationality, agency, position, and club-assignment fields. The example is shortened while preserving the observed response structure.

Notes

IDs are returned as strings in the verified response, while related numeric identifiers such as clubId, position IDs, and nationality IDs are numbers.
Nullable fields such as dateOfDeath, contractOptionId, and agency verification dates may be null.
Market values include both machine-readable numeric amounts and display-oriented compact/locale-formatted values.
relativeUrl is a site-relative profile path; portraitUrl is an absolute image URL.
Arrays such as clubAssignments, nominees, and participations can vary in length or be empty.