Find a channel
Find a TV channel by its name, an alias or a call sign, in any country, and get the id every other endpoint takes.
Free key and every planLive data
GEThttps://api.tvguideapi.com/v1/channels/search
Try itRuns the real call with your key
200 OK
Parameters
| Parameter | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
| q | query | string | required | Name, alias or call sign. | bbc one |
| country | query | list | optional | Country codes, ISO 3166-1 alpha-2, comma separated. | GB |
| limit | query | integer | optional | Page size, 1 to 500. Defaults to 100. | 100 |
Request
curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/search?q=bbc%20one"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/search?q=bbc%20one");
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/channels/search?q=bbc%20one", {
headers: { Authorization: `Bearer ${process.env.TVG_KEY}` },
});
const { data, meta } = await r.json();
import os, requests
r = requests.get(
"https://api.tvguideapi.com/v1/channels/search?q=bbc%20one",
headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"},
)
data = r.json()["data"]
Sample response
{
"data": [
{
"id": "ch_jw83a3xg",
"name": "BBC One",
"country": "GB",
"languages": [
"eng"
],
"categories": [
"general"
],
"owner": "BBC",
"launched": 1936,
"website": "https://www.bbc.co.uk/bbcone",
"feeds": 3
}
],
"meta": {
"count": 1,
"next": null,
"took_ms": 41
}
}