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.

1. Find the player#

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

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

{
  "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#

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:

# 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#

# 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)#

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 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#