Skills/TV Shows/What is on TV

What is on TV

0.1 credits / lookup

Returns a full daily TV schedule for a country, listing every episode airing that day with its air time and the show it belongs to. Defaults to today's schedule in the US if no date or country is specified.

Use when

You want a daily TV listing, what is on today, or the airings for a specific date.

Not for

A single show's full episode list (use the episode guide), or where to stream a show.

Cost

0.1 credits / lookup

What it accepts

Set these inside the intent when you run it.

dateoptional

The date to get the TV schedule for, as YYYY-MM-DD. Defaults to today.

countryoptional

The two-letter country code for the TV schedule. Defaults to US.

What you get back

A list of episodes airing on the specified day and country, with show title, episode details, and air times.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the TV Shows skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"whats_on","date":"2026-12-25","country":"GB"}}'

Example requests

  • What's on TV tonight?
  • What shows are airing on December 25th in the UK?
  • What is on TV today in Australia?