TV Show Search: Shows, Networks, Ratings & IMDb IDs (TVmaze)

Search TVmaze for TV shows by title and get genres, status, premiere/end dates, runtime, network or streaming channel, country, rating, IMDb ID, official site, poster and a plain-text summary. Free community API (CC BY-SA), no key needed.

What does TV Show Search do?

Search TV shows via TVmaze: genres, status, network, premiere date, rating, IMDb ID and summary.

What can you use it for?

• Build watchlists and recommendation datasets.
• Match show titles to IMDb IDs.
• Track running vs ended series.
• Enrich entertainment content databases.

Why use this Actor?

• Fast and cheap: lightweight HTTP-based Actor with no browser, so runs finish in seconds and cost very little.
• No API keys or accounts needed for the data source (see notes below).
• Clean, structured JSON that you can export as CSV, Excel, JSON or XML, or pull through the Apify API and integrations.
• Scheduling, webhooks and integrations: run it daily and send results to Google Sheets, Slack, Zapier, Make, n8n or your own API.

Input

Configure the run in the Input tab (all fields have sensible defaults).

Field	Type	Required	Default	Description
query	string	yes	-	Full or partial title, e.g. the office, dark, squid game.
maxResults	integer	no	10	Maximum shows to return.

Example input

{
  "query": "the office",
  "maxResults": 10
}

Output

Results are stored in the default dataset. Download them from the Output tab or via the API.

Example result

{
  "id": 526,
  "name": "The Office",
  "type": "Scripted",
  "language": "English",
  "genres": "Comedy",
  "status": "Ended",
  "premiered": "2005-03-24T00:00:00.000Z",
  "ended": "2013-05-16T00:00:00.000Z",
  "runtimeMinutes": 30,
  "network": "NBC",
  "streamingChannel": null,
  "country": "United States",
  "rating": 8.5,
  "imdbId": "tt0386676",
  "officialSite": "http://www.nbc.com/the-office",
  "summary": "Steve Carell stars in The Office , a fresh and funny mockumentary-style glimpse into the daily interactions of the eccentric workers at the Dunder Mifflin pa...",
  "image": "https://static.tvmaze.com/uploads/images/medium_portrait/481/1204342.jpg",
  "matchScore": 1.192,
  "url": "https://www.tvmaze.com/shows/526/the-office",
  "attribution": "Data from TVmaze.com (CC BY-SA 4.0)",
  "scrapedAt": "2026-09-26T00:11:23.856Z"
}

Output fields

Field	Type	Example
id	number	526
name	string	"The Office"
type	string	"Scripted"
language	string	"English"
genres	string	"Comedy"
status	string	"Ended"
premiered	string	"2005-03-24T00:00:00.000Z"
ended	string	"2013-05-16T00:00:00.000Z"
runtimeMinutes	number	30
network	string	"NBC"
streamingChannel	null	null
country	string	"United States"
rating	number	8.5
imdbId	string	"tt0386676"
officialSite	string	"http://www.nbc.com/the-office"
summary	string	"Steve Carell stars in The Office , a fresh and funny moc...
image	string	"https://static.tvmaze.com/uploads/images/medium_portrait...
matchScore	number	1.192
url	string	"https://www.tvmaze.com/shows/526/the-office"
attribution	string	"Data from TVmaze.com (CC BY-SA 4.0)"
scrapedAt	string	"2026-09-26T00:11:23.856Z"

How much does it cost?

The Actor is billed by Apify according to the pricing shown on the Pricing tab of this page. Runs are small and fast, and the Apify Free plan includes monthly platform credits so you can try it at no cost. You can set a maximum cost per run, and the Actor stops cleanly when that limit is reached.

Notes and limitations

• Data from TVmaze.com licensed CC BY-SA 4.0: keep the attribution when you reuse it.

Tips

• Start with a small test run, then scale up the input.
• Use Schedules to automate recurring runs and Webhooks or Integrations to deliver the data where you need it.
• Call the Actor from your code with the Apify API or the official JavaScript and Python clients.

FAQ

How many results does a search return?

TVmaze returns the best matches for a title, usually up to about ten.

Feedback

Found a bug or need an extra field? Open an issue from the Issues tab of this Actor and it will be looked at quickly.

More tools from the same author

• MusicBrainz Artist Search: Artists, Countries, Types & Tags - Search the open MusicBrainz music database for artists: type, country, active years and genre tags.
• Wikipedia Page Extractor: Text, Categories & Pageviews - Extract Wikipedia articles in any language: summary, full text, categories, images, Wikidata ID, pageviews.
• Open Library Book Search: Books, ISBN Lookup, Ratings & Covers - Search books or look up ISBNs: authors, editions, publishers, subjects, ratings and cover images.