Docs / Football API free

Managers, referees & venues#

Managers#

GET /api/v2/managers/

Param	Type	Description
`name`	string	Name search
`team_id`	int	Current club
`league_id`	int	Managers active in a league
`nationality_code`	string	ISO code
`tactical_profile`	string	Style classification filter
`team_style`	string	Team-style classification filter
`min_matches`	int	Minimum matches managed
`limit` / `offset`	int	Pagination

GET /api/v2/managers/{id}/          # profile: preferred formation, style, record
GET /api/v2/managers/{id}/career/   # clubs managed, spells, win rates
GET /api/v2/managers/{id}/matches/  # match log — date_from/to, league_id, team_id, status
GET /api/v2/managers/{id}/social/   # curated media

curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/managers/?league_id=85&min_matches=50"

Referees#

GET /api/v2/referees/

Param	Type	Description
`name`	string	Name search
`country_code`	string	ISO code
`league_id`	int	Referees active in a league
`min_matches`	int	Minimum matches officiated
`limit` / `offset`	int	Pagination

GET /api/v2/referees/{id}/          # profile + per-match aggregates (cards, fouls, penalties)
GET /api/v2/referees/{id}/matches/  # match log — date_from/to, league_id, season_id, status

Referee aggregates (yellow/red cards per match) are the data behind cards-market research — combine with the odds feed total_red_cards market.

Venues#

GET /api/v2/venues/

Param	Type	Description
`name`	string	Name search
`country_code`	string	ISO code
`city`	string	City filter
`min_capacity`	int	Minimum capacity
`team_id`	int	Home venue of a team
`limit` / `offset`	int	Pagination

GET /api/v2/venues/{id}/                # capacity, city, coordinates, home team
GET /api/v2/venues/{id}/competitions/   # competitions hosted at this venue

Venue photos: /img/venue/{id}/ — see Working with images.

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