Duaer

Get started

TV shows in Duaer

In Duaer: TVmaze: TV and streaming shows by name, with network, status, genres, rating, and summary. One successful search uses 1 credit.

What you get

Duaer TV shows searches TVmaze for TV and streaming series by name and returns the network or streaming service, status, genres, rating, and summary.

Pick Duaer Data → TV shows in the node creator, or open the data market. Related: Apple catalog search, Wikipedia.

When to use it

  • Check whether a series is still running and where it streams.
  • Compare ratings of shows with the same title.

When not to use it

Search on the canvas

  1. Open the node creator and pick Duaer Data → TV shows.
  2. Fill Words (such as the office).
  3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

  • GET https://api.duaer.com/v1/data/tv-shows?words=the%20office
  • Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-tv-shows
description: >-
  Duaer TV shows. TVmaze: TV and streaming shows by name, with network, status, genres, rating, and summary.
  One successful search uses 1 Duaer credit.
---

# Duaer TV shows

Duaer TV shows searches TVmaze for TV and streaming series by name and returns the network or streaming service, status, genres, rating, and summary.

## When to use

- Check whether a series is still running and where it streams.
- Compare ratings of shows with the same title.

## When not to use

- Podcasts, apps, and music. Use https://skills.duaer.com/apple-search.md.
- Background on a show or actor. Use https://skills.duaer.com/wikipedia.md.

## Call

`GET https://api.duaer.com/v1/data/tv-shows?words=the%20office`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words`.

- `words` — Words in the show name, such as the office.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/tv-shows?words=the%20office` — the US and UK versions of The Office.
- `GET https://api.duaer.com/v1/data/tv-shows?words=dark` — shows named Dark.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `name`, `type`, `language`, `genres` — show identity.
- `status`, `premiered`, `ended`, `network` — whether it runs and where.
- `rating`, `text`, `image`, `officialSite` — TVmaze rating, summary, poster, and site.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/apple-search.md — Duaer Apple catalog search
- https://skills.duaer.com/wikipedia.md — Duaer Wikipedia

Questions

How many credits does a TV shows search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Where does the rating in Duaer TV shows come from?

It is the TVmaze user rating, out of 10.

In this section

Get started

Apple catalog search in Duaer

In Duaer: Apple iTunes Search: podcasts, music, apps, books, movies, and TV in any store country, with genre, price, and link. One successful search uses 1 credit.

Get started

Wikipedia in Duaer

In Duaer: Wikipedia articles in any language edition with the short description, a text excerpt, and a thumbnail, for quick background on a term. One successful search uses 1 credit.