# Bzzoiro Sports Data API

> Free REST API for football data and ML predictions.

## Overview

Bzzoiro Sports Data (BSD) provides a free, unlimited REST API for football (soccer) data. The API covers 30+ leagues, 3000+ teams, 8900+ players, and uses CatBoost ML models for match predictions.

Base URL: https://sports.bzzoiro.com/api/
Auth: Token-based (free registration)
Format: JSON
Rate limits: None

## Endpoints

- GET /api/leagues/ - Active football leagues
- GET /api/teams/?country= - Football teams (filterable by country)
- GET /api/events/?date_from=&date_to=&league=&status= - Matches with odds
- GET /api/live/ - Real-time live scores with incidents and statistics
- GET /api/predictions/?upcoming=true - CatBoost ML match predictions
- GET /api/players/?team=&nationality=&position= - Player profiles (8900+)
- GET /api/player-stats/?player=&event=&team= - Per-match player statistics (139k+)
- GET /img/{type}/{api_id}/ - Team/league logos and player photos

## Authentication

Register free at https://sports.bzzoiro.com/register/ to get an API token.
Include in requests: Authorization: Token YOUR_API_KEY

## Documentation

- Full docs: https://sports.bzzoiro.com/docs/
- OpenAPI schema: https://sports.bzzoiro.com/api/schema/
- Swagger UI: https://sports.bzzoiro.com/api/docs/
- ReDoc: https://sports.bzzoiro.com/api/redoc/

## Features

- 30+ football leagues (Premier League, La Liga, Serie A, Bundesliga, Ligue 1, etc.)
- Real-time live scores with minute-by-minute incidents
- Match odds (1X2, Over/Under 1.5/2.5/3.5, BTTS)
- CatBoost ML predictions with confidence scores
- 8,900+ player profiles with market values
- 139,000+ per-match player statistics (goals, assists, xG, xA, passes, tackles, etc.)
- Team and player logos/photos
- No rate limits, 100% free