Country coverage
How full the TV data is for a country on a day: the share of programmes with a description, category, episode number and more.
Free key and every planLive data
GEThttps://api.tvguideapi.com/v1/countries/{cc}/coverage
Try itRuns the real call with your key
200 OK
Parameters
| Parameter | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
| cc | path | string | required | Country code, ISO 3166-1 alpha-2. | GB |
| date | query | date | optional | The day, YYYY-MM-DD. Defaults to today. | 2026-10-07 |
Request
curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/countries/GB/coverage"
$ch = curl_init("https://api.tvguideapi.com/v1/countries/GB/coverage");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("TVG_KEY")],
]);
$answer = json_decode(curl_exec($ch), true);
const r = await fetch("https://api.tvguideapi.com/v1/countries/GB/coverage", {
headers: { Authorization: `Bearer ${process.env.TVG_KEY}` },
});
const { data, meta } = await r.json();
import os, requests
r = requests.get(
"https://api.tvguideapi.com/v1/countries/GB/coverage",
headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"},
)
data = r.json()["data"]
Sample response
{
"data": {
"country": "GB",
"date": "2026-10-07",
"slots": 18400,
"fill": {
"title": 100,
"descr": 92.1,
"category": 88.4,
"episode_num": 41,
"sub_title": 38.2,
"icon": 52.7
},
"with_join": {
"episode_num": 55.3,
"sub_title": 47.9
}
},
"meta": {
"took_ms": 23
}
}