Contents
What Sportmonks provides
Each TV station record includes:
– TV station ID and name
– station URL (where available)
– image path for the broadcaster’s logo
TV station records are associated with fixtures, meaning you can retrieve broadcast information either by querying a specific fixture or by looking up a broadcaster directly to see which upcoming or past matches it is showing.
Endpoints
There are three TV station endpoints:
GET All TV Stations returns every TV station available within your subscription.
GET https://api.sportmonks.com/v3/football/tv-stations?api_token=YOUR_TOKEN
GET TV Station by ID returns a single TV station by its ID.
GET
https://api.sportmonks.com/v3/football/tv-stations/{tv_station_id}?api_token=YOUR_TOKEN
GET TV Stations by Fixture ID returns all broadcasters showing a given fixture. This is the most common entry point when you want to display broadcast information alongside a specific match.
GET
https://api.sportmonks.com/v3/football/tv-stations/fixtures/{fixture_id}?api_token=YOUR_TOKEN
Includes
TV station records support two includes:
– fixtures returns the fixtures associated with a TV station
– countries adds the countries the TV station broadcasts in
Example: retrieving a TV station with its associated countries:
GET
https://api.sportmonks.com/v3/football/tv-stations/{tv_station_id}?api_token=YOUR_TOKEN&include=countries
You can also retrieve TV station data directly from a fixture using the tvStations include parameter in any fixture endpoint request, rather than querying TV stations separately.
From the fixtures endpoints, you can also use:
– GET Upcoming Fixtures by TV Station ID
– GET Past Fixtures by TV Station ID
to retrieve all fixtures broadcasting on a given station.
What you can build with TV station data
Broadcast guides
Show fans which channel each match is airing on. This is useful for supporter apps covering competitions such as the Premier League, Champions League, La Liga, Bundesliga, Serie A, and more.
Fixture enrichment
Add broadcaster logos and names to match pages using the tvStations include on fixture requests, without making a separate API call.
Station-based fixture listings
Use GET Upcoming Fixtures by TV Station ID to build a programme guide showing all upcoming matches on a given broadcaster.
Regional broadcast filtering
Combine the countries include with station data to surface only the broadcasters relevant to a user’s region.
Media partnership tools
Aggregate broadcast data across multiple leagues to give rights holders or publishers an overview of coverage across their portfolio.
Availability
TV station data is included in all Starter, Growth, Pro, and Enterprise plans.
The fixtures and broadcasters available to you correspond to the leagues within your subscription.
You can explore and test the TV station endpoints using the Sportmonks Postman collection or the API tester in MySportmonks.
Try it free. All paid plans include a 14-day free trial, and the forever free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.
FAQs about TV stations
