Skills/TV Shows/Episode guide

Episode guide

0.1 credits / lookup

Returns the complete ordered episode list for a TV series, with each episode's season and episode number, title, air date, runtime, and summary. Specials and one-off episodes can be included on request.

Use when

You want an episode guide, air dates, or the summary of a specific episode.

Not for

A show overview (use the profile operation), or the cast.

Cost

0.1 credits / lookup

What it accepts

Set these inside the intent when you run it.

showrequired

The name of the TV series to get the episode guide for.

specialsoptional

Set to true to include specials and one-off episodes. Defaults to false.

What you get back

An ordered list of episodes with season and episode numbers, titles, air dates, runtimes, and summaries.

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":"episode_guide","show":"The Bear"}}'

Example requests

  • When does The Bear season 4 come out?
  • List all the episodes of Breaking Bad with their air dates.
  • What happened in season 2 episode 3 of Succession?