---
title: TV, broadcasts & social
description: Where matches are televised per country, TV channel data, and curated social media linked to teams, players and matches.
badge: free
---

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

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

```bash
# "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"
```

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.