Skip to main content

Player Detail (Full)

GET /api/v1/player/{playerId}?sport=football
Returns career, honors, transfers, totals, teams, and related players.
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/player/527r3ij658a67ev"
{
  "success": true,
  "player": {
    "id": "527r3ij658a67ev",
    "name": "Kylian Mbappé",
    "team": { "id": "5xvkjoiyyyix793", "name": "Real Madrid" },
    "position": "F", "age": 27,
    "country": { "name": "France" }
  },
  "playerTransfers": [],
  "playerHonors":    { "honors": [] },
  "playerTotals":    { "playerTotals": [] },
  "teams":           [],
  "relatedPlayers":  []
}

Player Trophies

GET /api/v1/player/{playerId}/trophies
Returns honor types with per-season items (Mbappé → 30 honor types).

Player Salary

GET /api/v1/player/{playerId}/salary
Returns the player’s season-by-season salary plus a top-earners comparison for context.
{
  "success": true,
  "seasonSalaries": [
    {
      "salary": { "season": { "year": "2025-2026" }, "mode": "€", "weeklySalary": 53462, "annualSalary": 2780000 },
      "team":   { "id": "...", "name": "Inter Milan", "slug": "inter-milan" },
      "comp":   { "id": "...", "name": "ITA Serie A" }
    }
  ],
  "topPlayers":    [{ "name": "Dušan Vlahović", "salary": { "mode": "€", "annualSalary": 22220000 } }],
  "otherPlayers":  []
}

Player Transfers

GET /api/v1/player/{playerId}/transfers
Returns the player’s complete transfer history (Mbappé → 8 entries).
GET /api/v1/player/{playerId}/map
Returns the top 20 globally popular players (Messi, Ronaldo, …). Cache TTL: 10 minutes for all player endpoints.
Last modified on June 29, 2026