---
title: Get a football player profile
description: Search a player, then pull bio, per-match stats, season aggregates, transfers, career and photos — the complete profile workflow.
---

# Get a football player profile

Everything a player page needs: bio, current team, season stats, match log,
transfer history, career and a photo. Free tier throughout. Full parameter
reference: [Teams, players & transfers](/docs/football/teams-players/).

## 1. Find the player

Search by name (or list a whole squad with `team_id`):

```bash
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/players/?name=messi"
```

```json
{
  "count": 1,
  "results": [
    { "id": 12994, "name": "Lionel Messi", "position": "F",
      "nationality_code": "AR", "team_id": 2953, "...": "..." }
  ]
}
```

Other filters: `team_id`, `national_team_id`, `nationality_code`, `position`.

## 2. Bio and profile

```bash
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/players/12994/"
```

Returns the full profile: date of birth, height, preferred foot, shirt
number, position, market value, current team and contract info where known.

## 3. Stats

Per-match statistics, filterable by season, team, league or date range:

```bash
# This season's match-by-match log
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sports.bzzoiro.com/api/v2/players/12994/stats/?season_id=1635"

# Only matches for a given team, in a date window
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sports.bzzoiro.com/api/v2/players/12994/stats/?team_id=2953&date_from=2026-01-01"
```

Each row is one match: minutes, goals, assists, shots, passes, duels, rating.
Aggregate client-side for season totals, or use the league leaderboards
(`/api/v2/leagues/{id}/top/scorers/`) for ranked views.

## 4. Transfers and career

```bash
# Transfer history (fees, dates, from/to clubs)
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/players/12994/transfers/"

# Season-by-season career summary
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/players/12994/career/"

# National team record
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/players/12994/national-team/"
```

There is also a global transfers feed (`/api/v2/transfers/`) filterable by
player, club, fee and date — useful for a "latest transfers" widget.

## 5. Social feed (optional)

```bash
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/players/12994/social/?type=video"
```

Returns curated tweets and videos linked to the player. `type` is `tweet` or
`video`.

## 6. Photo

The [Image API](/docs/images/) serves player photos by the same id, no auth:

```
https://sports.bzzoiro.com/img/player/12994/
https://sports.bzzoiro.com/img/player/12994/?bg=transparent      # background removed
https://sports.bzzoiro.com/img/player/12994/?sor=true            # cut-out face style if available
https://sports.bzzoiro.com/img/player/12994/?sor=true&bg=transparent
```

`?sor=true` silently falls back to the normal photo when no cut-out exists —
safe to use unconditionally.

## Putting it together

| Section | Request | Suggested cache |
|---|---|---|
| Header/bio | `/api/v2/players/{id}/` | 1 day |
| Match log | `/api/v2/players/{id}/stats/?season_id=…` | 10 min |
| Transfers | `/api/v2/players/{id}/transfers/` | 1 day |
| Career | `/api/v2/players/{id}/career/` | 1 day |
| Photo | `/img/player/{id}/` | handled for you (30 days) |