> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Players

> Player profile, trophies, season salary with top-earners comparison, transfer history, and related players

## Player Detail (Full)

```text theme={null}
GET /api/v1/player/{playerId}?sport=football
```

Returns career, honors, transfers, totals, teams, and related players.

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/player/527r3ij658a67ev"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/player/527r3ij658a67ev"
  ```
</CodeGroup>

```json theme={null}
{
  "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

```text theme={null}
GET /api/v1/player/{playerId}/trophies
```

Returns honor types with per-season items (Mbappé → 30 honor types).

## Player Salary

```text theme={null}
GET /api/v1/player/{playerId}/salary
```

Returns the player's season-by-season salary plus a top-earners comparison for context.

```json theme={null}
{
  "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

```text theme={null}
GET /api/v1/player/{playerId}/transfers
```

Returns the player's complete transfer history (Mbappé → 8 entries).

## Related Players

```text theme={null}
GET /api/v1/player/{playerId}/map
```

Returns the top 20 globally popular players (Messi, Ronaldo, …).

**Cache TTL:** 10 minutes for all player endpoints.