Search television series
search_titlesSearch tvsubtitles.net for a TV series by name, filtering by year or media type, and optionally retrieving subtitle, episode, and season counts.
Instructions
Search tvsubtitles.net for a television series by name. The site catalogues television only, so 'media_type' takes 'tv' or 'any' and a film is refused rather than answered with an absence. Each row carries the id the other tools take, the years the site publishes for the show, and the languages it draws a flag for. Pass 'with_counts' for how many subtitles, episodes and seasons the site holds per show: it publishes those three on its catalogue index rather than on the page a search answers with, so reading them costs one further request over a large page, and each counts the whole show. Show ids come from here and are never built by hand.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Keep only shows whose published years cover this one. When that leaves nothing, the search is reported without it and a note says the year was set aside. | |
| limit | No | Rows to render, 20 by default and 100 at most. | |
| query | Yes | The name of a series, or part of one. The site matches on the name alone. | |
| media_type | No | 'tv' or 'any' both search the catalogue, which holds television only. 'movie' is refused, because answering it with an empty list would report an absence this site cannot establish. | |
| with_counts | No | Read each row's subtitle, episode and season counts from the site's catalogue index, which costs one further request over a page of several hundred kilobytes. Each figure counts the whole show rather than this search, each is read on its own, and a cell the index leaves empty keeps a null. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | ||
| query | Yes | ||
| cached | Yes | True when the answer was served from memory rather than the site. | |
| source | Yes | ||
| results | Yes | ||
| counts_scope | Yes | What the three counts count, when they were read: every season of that show together, which is a different figure from the rows this search served. Null when no counts were asked for. | |
| result_count | Yes | Rows rendered here. | |
| total_counts | Yes | What 'total_available' counted: the rows this one search came back with. | |
| filters_applied | Yes | ||
| filters_dropped | Yes | ||
| total_available | Yes | Rows the site's answer held, before any were rendered. |