TV channel directory

# find the channel, then read its day
curl -H "Authorization: Bearer $TVG_KEY" \
  "https://api.tvguideapi.com/v1/channels/search?q=france%2024&country=FR"

curl -H "Authorization: Bearer $TVG_KEY" \
  "https://api.tvguideapi.com/v1/channels/ch_wq31kfsa/schedule?tz=Europe/Paris"

$h = ["Authorization: Bearer " . getenv("TVG_KEY")];
$ch = curl_init("https://api.tvguideapi.com/v1/channels/search?q=france%2024&country=FR");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $h]);
$id = json_decode(curl_exec($ch), true)["data"][0]["id"];

const h = { Authorization: `Bearer ${process.env.TVG_KEY}` };
const s = await fetch("https://api.tvguideapi.com/v1/channels/search?q=france%2024&country=FR", { headers: h });
const { data } = await s.json();
const day = await fetch(`https://api.tvguideapi.com/v1/channels/${data[0].id}/schedule`, { headers: h });

import os, requests
h = {"Authorization": f"Bearer {os.environ['TVG_KEY']}"}
r = requests.get("https://api.tvguideapi.com/v1/channels/search", params={"q": "france 24", "country": "FR"}, headers=h)
ch = r.json()["data"][0]["id"]

// GET /v1/channels/search?q=france 24&country=FR, in short
{
    "data": [
        {
            "id": "ch_wq31kfsa",
            "name": "France 24",
            "country": "FR",
            "categories": [
                "news"
            ],
            "listings_from": "2025-10-03"
        }
    ],
    "meta": {
        "count": 1
    }
}