TV, broadcasts & social#
TV channels#
GET /api/v2/tv-channels/
| Param | Type | Description |
|---|---|---|
country_code |
string | ISO code, e.g. AR |
name |
string | Name search |
limit / offset |
int | Pagination |
GET /api/v2/tv-channels/{id}/
GET /api/v2/tv-channels/{id}/broadcasts/ # what this channel shows — date_from/to, league_id, season_id
/tv-channels/{id}/broadcasts/ defaults to the same one-week window as
/broadcasts/ below when you pass neither date_from nor date_to.
Broadcasts#
Which channel shows which match, per country:
GET /api/v2/broadcasts/
| Param | Type | Description |
|---|---|---|
event_id |
int | One match |
country_code |
string | Viewer country |
channel_id |
int | One channel |
league_id / team_id / season_id |
int | Scope |
date_from / date_to |
date | Kickoff window |
limit / offset |
int | Pagination |
Results are ordered by kick-off ascending. If you pass neither date_from nor
date_to, the response is the upcoming week — kick-off from 3 hours ago to
7 days out. Setting either bound disables that default, so date_from is how
you reach past fixtures (date_from=2000-01-01 gives you the whole archive).
Listings are typically published about a week before kick-off, and rights holders in some markets publish late. A fixture further out than that legitimately has no channel yet, so an empty result for a match next month is expected rather than missing data.
# "Where can I watch it?" for one match, for Argentine viewers
curl -H "Authorization: Token YOUR_API_KEY" \
"https://sports.bzzoiro.com/api/v2/events/223510/broadcasts/?country_code=AR"
# Upcoming Premier League on TV for viewers in the UK
curl -H "Authorization: Token YOUR_API_KEY" \
"https://sports.bzzoiro.com/api/v2/broadcasts/?country_code=GB&league_id=1&limit=200"
Responses cached ~1 hour.
Social feed#
Curated tweets and videos linked to entities:
GET /api/v2/social/
| Param | Type | Description |
|---|---|---|
type |
string | tweet · video |
team_id / event_id / player_id / manager_id |
int | Linked entity |
league_id / season_id |
int | Scope |
account_verified |
bool | Only verified accounts |
published_after / published_before |
datetime | Time window |
limit / offset |
int | Pagination |
Also available as per-entity shortcuts: /events/{id}/social/,
/teams/{id}/social/, /players/{id}/social/, /managers/{id}/social/.
Responses cached ~15 minutes.