Free key: real listings for yesterday and today, 500 calls a day, no card148 countriesGet yours in 30 seconds
tvguideapi

Last 30 days

API uptimefrom the monitorIncidentsfrom the monitor
All systems

Working normally

Checked every minute from outside our own servers.

Documentation/Countries

List countries

Every country we hold TV listings for, with its channel count, its guide feeds and how many programmes it has today.

Free key and every planLive data
GEThttps://api.tvguideapi.com/v1/countries
Try itRuns the real call with your key
200 OK

Parameters

None: call it as it is.

Request

curl -H "Authorization: Bearer $TVG_KEY" \
  "https://api.tvguideapi.com/v1/countries"

Sample response

{
    "data": [
        {
            "code": "GB",
            "name": "United Kingdom",
            "channels": 612,
            "feeds": 9,
            "listings_today": 18400
        },
        {
            "code": "TH",
            "name": "Thailand",
            "channels": 240,
            "feeds": 5,
            "listings_today": 6100
        }
    ],
    "meta": {
        "count": 2,
        "next": null,
        "took_ms": 41
    }
}

Errors