TVmaze Shows — Titles, Genres, Network and Ratings avatar

TVmaze Shows — Titles, Genres, Network and Ratings

Pricing

from $0.50 / 1,000 results

Go to Apify Store
TVmaze Shows — Titles, Genres, Network and Ratings

TVmaze Shows — Titles, Genres, Network and Ratings

Search TVmaze for television shows and get flat rows — name, type, language, genres, network, premiere date, rating and status. Free public API, no key.

Pricing

from $0.50 / 1,000 results

Rating

0.0

(0)

Developer

alaudin burki

alaudin burki

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

21 days ago

Last modified

Features

Limited permissions

Share

Search TVmaze for a television show and get one flat row per matching show — name, type, language, genres, status, runtime, premiere and end dates, average rating, network and country. The search field comes prefilled with girls so a first run returns results immediately; change it to any title. No API key and no account are needed.

How to use

  1. Type a show title into Search text — girls, breaking bad, the wire.
  2. Leave Max rows at 500; the search endpoint returns a short page of matches, so the cap does not bite.
  3. Run the Actor. Matches appear in the dataset's Overview tab, best match first, and a SUMMARY record in the key-value store reports the count.
{
"query": "girls",
"maxItems": 500
}

Inputs

InputPurposeDefault
queryThe show title to search for. The source matches loosely on titles, so partial names work.girls (prefilled in the form)
maxItemsHard ceiling on rows. A search returns at most ten matches, so this never truncates a run.500
maxPagesKept for consistency with other Actors. The search answers in one response with no paging, so the Actor makes one request per run and this setting does not change the result.5

Output

One row per matching show, sorted by search relevance, highest first.

FieldMeaning
nameThe show's title as TVmaze writes it.
typeThe show's format, e.g. Scripted, Reality, Animation, Documentary. Emitted on every row even though it is not listed in the dataset view.
languageThe show's language as a name, e.g. English — TVmaze does not store an ISO code here.
genresThe show's genres joined into one comma-separated string (Drama, Romance), because a dataset row must be flat.
statusThe show's status, e.g. Running, Ended, To Be Determined.
runtimeEpisode runtime in minutes. Omitted for shows with no fixed length.
premieredFirst air date as YYYY-MM-DD, when known.
endedLast air date as YYYY-MM-DD, empty for a running show or one with no recorded end.
ratingTVmaze's average user rating on its own 0–10 scale. Omitted when too few people have voted.
weightTVmaze's 0–100 popularity weight. Not comparable with any other site's popularity figure.
networkThe broadcasting network's name. Omitted for streaming-only shows, which TVmaze files under a web channel this Actor does not map.
countryThe network's country name (United States), not a code. Omitted with network.
officialSiteThe show's official website, when TVmaze lists one. It is not guaranteed to still be live.
urlThe show's TVmaze page.
matchScoreHow well the show matched your search text, as TVmaze scores it — higher is a better match. This is relevance, not quality, and not the rating.

Each row also carries id (the show's TVmaze id) with source, firstSeenAt and scrapedAt, so a row remains identifiable after export.

Why this is different

TVmaze returns each result wrapped in a show object whose network, country and rating sit several levels deep. This Actor resolves those paths into one standalone flat row per show, joins the genre array into a single field, and sorts by the source's own relevance score — so the best match is the first row, not whichever row the API happened to send first. Rows are de-duplicated on the show id, so the same show appearing twice under two search terms cannot duplicate in a run.

Limitations

  • Search, not a catalogue. The endpoint returns a single short page of matches — at most ten shows for a query. This Actor does not page through the whole TVmaze database.
  • Shows only. No episodes, no cast, no schedules, no images.
  • rating is a user average, not a critic score, and it is absent when there are too few votes.
  • Streaming-only shows have no network, so network and country are missing on those rows; TVmaze's separate web-channel field is not mapped here.
  • genres is flattened to a comma-separated string, which is easy to load but loses the array type.
  • Loose matching. A search for a common word can return unrelated shows; judge matchScore and the title rather than assuming the first row is the show you meant.
  • Data is whatever TVmaze has. Missing premiere dates, official sites that have moved, and gaps for obscure titles all happen at the source.

FAQ

Do I need an API key? No. The request carries no key or token.

Why does the form already say "girls"? It is a prefill so a first run returns something. Replace it with the title you actually want.

Why do I get only a handful of rows? Because the search endpoint returns a short page of matches, not the whole catalogue. Run once per title.

Does this include episodes or air dates? No. It returns show-level fields only.

Why is genres a string and not a list? A dataset row must be flat, so the array is joined with commas — ready for a spreadsheet column.

Pricing and limits

The price is shown on the Actor's Apify pricing panel before you run it. maxItems and maxPages are enforced in code and the run records its stop reason in SUMMARY. In practice a run is one request and a small number of rows, because the size of the result is set by the source's search page, not by any setting here.