Every country

What it is for

This is the top of the directory. Each row gives a country's two-letter code, which every country endpoint takes, with its channel count and today's activity: how many channels have listings today and how many programmes are listed.

Use it to build a country picker, to check coverage before you build for a market, or to watch how busy a country's schedule is from day to day. UK listings use GB, as ISO 3166 does.

Try it

Calls the real API with your key and shows the answer below. Your key stays in this browser and fills in on every docs page.

Code

Built from the form above, with your key in place. The language you pick is remembered.

curl "https://api.tvschedule.org/v1/countries" \
  -H "X-API-Key: <your key>"

Parameters

None. The key is all it needs.

Returns

A list under data, with meta.count beside it.

Example answer

A real answer from our data, cut to three rows, so you can see the shape before you run anything.

{
    "data": [
        {
            "code": "AD",
            "name": "Andorra",
            "channels": 1,
            "channels_on_air_today": 1,
            "programmes_today": 20
        },
        {
            "code": "AE",
            "name": "United Arab Emirates",
            "channels": 669,
            "channels_on_air_today": 678,
            "programmes_today": 20275
        },
        {
            "code": "AF",
            "name": "Afghanistan",
            "channels": 1,
            "channels_on_air_today": 1,
            "programmes_today": 49
        }
    ],
    "meta": {
        "count": 179,
        "took_ms": 2
    }
}

Errors

Next calls