Skills/TV Shows/Look up by external id

Look up by external id

0.1 credits / lookup

Resolves a TV show from an identifier in another catalog, returning the full series record. Useful when you have an external film or TV database identifier and want to retrieve the show's details without knowing its title.

Use when

You already hold an external catalog identifier and want the matching series record.

Not for

Searching by name (use find a show), or any person lookup.

Cost

0.1 credits / lookup

What it accepts

Set these inside the intent when you run it.

external_idrequired

An identifier from another TV or film catalog. Supports IMDB (tt-prefixed), and two numeric TV catalog identifiers.

What you get back

The full show profile matching the supplied external identifier, with network, genres, status, and summary.

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":"external_id_bridge","external_id":"tt0944947"}}'

Example requests

  • Look up the show with IMDB id tt0944947.
  • Find the series for this external TV database id.
  • Get details for the show with IMDB code tt4574334.