TVmaze Shows — Titles, Genres, Network and Ratings
Pricing
from $0.50 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
21 days ago
Last modified
Categories
Features
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
- Type a show title into Search text —
girls,breaking bad,the wire. - Leave Max rows at 500; the search endpoint returns a short page of matches, so the cap does not bite.
- Run the Actor. Matches appear in the dataset's Overview tab, best match first, and a
SUMMARYrecord in the key-value store reports the count.
{"query": "girls","maxItems": 500}
Inputs
| Input | Purpose | Default |
|---|---|---|
query | The show title to search for. The source matches loosely on titles, so partial names work. | girls (prefilled in the form) |
maxItems | Hard ceiling on rows. A search returns at most ten matches, so this never truncates a run. | 500 |
maxPages | Kept 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.
| Field | Meaning |
|---|---|
name | The show's title as TVmaze writes it. |
type | The show's format, e.g. Scripted, Reality, Animation, Documentary. Emitted on every row even though it is not listed in the dataset view. |
language | The show's language as a name, e.g. English — TVmaze does not store an ISO code here. |
genres | The show's genres joined into one comma-separated string (Drama, Romance), because a dataset row must be flat. |
status | The show's status, e.g. Running, Ended, To Be Determined. |
runtime | Episode runtime in minutes. Omitted for shows with no fixed length. |
premiered | First air date as YYYY-MM-DD, when known. |
ended | Last air date as YYYY-MM-DD, empty for a running show or one with no recorded end. |
rating | TVmaze's average user rating on its own 0–10 scale. Omitted when too few people have voted. |
weight | TVmaze's 0–100 popularity weight. Not comparable with any other site's popularity figure. |
network | The broadcasting network's name. Omitted for streaming-only shows, which TVmaze files under a web channel this Actor does not map. |
country | The network's country name (United States), not a code. Omitted with network. |
officialSite | The show's official website, when TVmaze lists one. It is not guaranteed to still be live. |
url | The show's TVmaze page. |
matchScore | How 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.
ratingis a user average, not a critic score, and it is absent when there are too few votes.- Streaming-only shows have no
network, sonetworkandcountryare missing on those rows; TVmaze's separate web-channel field is not mapped here. genresis 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
matchScoreand 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.