# TV Shows

> Skill `tv` on Faro. 7 sub-skills.

Looks up TV show information: episode schedules, cast, ratings, air dates, and upcoming premieres. Covers thousands of shows across all networks and streaming platforms. Also finds actor profiles, bridges external catalog identifiers, and lists what is airing on any given day.

**Category:** Knowledge & Reference  
**Tags:** tv, shows, episodes, series, cast  
**Use when:** You need accurate, current facts about a TV series, its episodes, its cast, a TV actor, or what is airing on a date.  
**Not for:** Movies, where to stream a show or regional availability, aggregated critic ratings, personal watchlists, or plot recaps beyond the provided summary.  
**Returns:** information — Returns the facts plus a source link for each item, used to credit the data source and link back. Not a downloadable file.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/tv/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Find the show Breaking Bad."}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run tv "Find the show Breaking Bad."
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Find the show Breaking Bad.
- What shows has Pedro Pascal been in?
- Give me the full details on Succession.
- When does The Bear season 4 come out?

## Sub-skills

### Find a show

Finds TV shows matching a name, ranked by relevance.

**Cost:** 0.1 credits / search

**Use when:** You have a show title, possibly rough or ambiguous, and want the matching series.

**Details:** https://askfaro.com/llms/skills/tv/find_show.md

---

### Find a person

Finds a TV actor or crew member by name and returns their profile and TV credits.

**Cost:** 0.1 credits / lookup

**Use when:** You want an actor's profile or the list of shows a person has appeared in.

**Details:** https://askfaro.com/llms/skills/tv/find_person.md

---

### Show profile

Returns a full profile of a series, optionally with its cast, episodes, or seasons.

**Cost:** 0.1 credits / lookup

**Use when:** You want everything about one series, and can fold cast, episodes, or seasons into one call.

**Details:** https://askfaro.com/llms/skills/tv/show_profile.md

---

### Episode guide

Lists a series' episodes in order, with air dates and summaries.

**Cost:** 0.1 credits / lookup

**Use when:** You want an episode guide, air dates, or the summary of a specific episode.

**Details:** https://askfaro.com/llms/skills/tv/episode_guide.md

---

### Cast and characters

Lists a series' cast, pairing each actor with the character they play.

**Cost:** 0.1 credits / lookup

**Use when:** You want who is in a show and the roles they play.

**Details:** https://askfaro.com/llms/skills/tv/show_cast.md

---

### Look up by external id

Resolves a TV show from an identifier in another TV or film catalog.

**Cost:** 0.1 credits / lookup

**Use when:** You already hold an external catalog identifier and want the matching series record.

**Details:** https://askfaro.com/llms/skills/tv/external_id_bridge.md

---

### What is on TV

Lists the TV episodes airing on a given day in a given country.

**Cost:** 0.1 credits / lookup

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

**Details:** https://askfaro.com/llms/skills/tv/whats_on.md

---

---
On the web: https://askfaro.com/search/tv