API Docs / Directory
Directory guide
Countries, channels and the ids every other endpoint takes.
The directory is where every id comes from. Countries list their channels; each channel has one stable id that the listings, XMLTV and statistics all take. The whole directory is on the free key.
Every countryGET /v1/countriesEvery country with listings, its channel count and programmes today. A country's channelsGET /v1/countries/{cc}/channelsEvery channel in a country, with ids, names and categories. Find a channelGET /v1/channels/search/{q}Find a channel by name, alias or call sign. One channelGET /v1/channels/{id}One channel: names, country, languages, categories and launch year.
Finding a channel
Search by name, alias or call sign, and narrow it by country when a name is used in several:
curl
curl "https://api.tvschedule.org/v1/channels/search/BBC+One?country=GB" -H "X-API-Key: $TVS_KEY"
A country at a time
/v1/countries/{cc}/channels lists every channel in a country, 100 at a time by default; follow next_cursor for the rest (pagination).