Docs / Football API free

Teams, players & transfers#

Teams#

GET /api/v2/teams/

Param	Type	Description
`country_code`	string	ISO country code, e.g. `AR`
`league_id` / `season_id`	int	Teams competing in a league/season
`in_competition`	bool	Only teams currently in an active competition
`is_women`	bool	Women's teams
`name`	string	Name search
`limit` / `offset`	int	Pagination

GET /api/v2/teams/{id}/           # profile: venue, coach, colours, country
GET /api/v2/teams/{id}/squad/     # current squad grouped by position
GET /api/v2/teams/{id}/fixtures/  # date_from, date_to, league_id, status
GET /api/v2/teams/{id}/social/    # curated tweets/videos (type filter)

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sports.bzzoiro.com/api/v2/teams/755/fixtures/?status=upcoming&limit=5"

Players#

GET /api/v2/players/

Param	Type	Description
`name`	string	Name search
`team_id`	int	Current club
`national_team_id`	int	Current national-team squad
`nationality_code`	string	ISO code, e.g. `AR`
`position`	string	`G` · `D` · `M` · `F`
`limit` / `offset`	int	Pagination

GET /api/v2/players/{id}/                # bio, market value, skills
GET /api/v2/players/{id}/stats/          # per-match log — season_id, team_id, league_id, date_from/to
GET /api/v2/players/{id}/transfers/      # transfer history with fees
GET /api/v2/players/{id}/career/         # season-by-season summary
GET /api/v2/players/{id}/national-team/  # international record
GET /api/v2/players/{id}/social/         # tweets/videos

The full workflow with examples: Get a football player profile.

Transfers feed#

GET /api/v2/transfers/

Param	Type	Description
`player_id`	int	One player's transfer history
`team_id`	int	In or out of this club
`from_team_id` / `to_team_id`	int	Direction-specific
`date_from` / `date_to`	date	Transfer date window
`min_fee`	int	Minimum fee (EUR)
`has_fee`	bool	Only transfers with a disclosed fee
`ordering`	string	Sort field, prefix `-` for descending

Note: the dataset includes forward-dated moves (announced loans/returns that haven't happened yet). For a "latest transfers" widget, always cap date_to at today.

World Cup squads#

GET /api/v2/worldcup/squads/              # team, group, status, has_player
GET /api/v2/worldcup/squads/{team_id}/

Tournament squad lists with per-player status — built for tournament hub pages.

Images#

Badges and photos come from ids, no extra calls: /img/team/{id}/, /img/player/{id}/?sor=true&bg=transparent — see Working with images.

View this page as Markdown · Found a mistake? Tell us