Television data
Last verified: November 12, 2026
100% uptime: the documentation responded in 5 of 5 checks over the last 30 days. Median response time: 445 ms.
From TVDB's OpenAPI specification (version 3.0.0), spec updated June 21, 2021, via APIs.guru.
API v3 targets v2 functionality with a few minor additions. The API is accessible via https://api.thetvdb.com and provides the following REST endpoints in JSON format. How to use this API documentation ---------------- You may browse the API routes without authentication, but if you wish to send requests to the API and see response data, then you must authenticate. 1. Obtain a JWT token by POST ing to the /login route in the Authentication section with your API key and credentials. 1.
| Method | Path | What it does |
|---|---|---|
| GET | /episodes/{id} | Returns the full information for a given episode id. Deprecation Warning: The director key will be deprecated in favor of the new directors… |
| GET | /languages | All available languages. These language abbreviations can be used in the Accept-Language header for routes that return translation records. |
| GET | /languages/{id} | Information about a particular language, given the language ID. |
| POST | /login | Returns a session token to be included in the rest of the requests. Note that API key authentication is required for all subsequent requests… |
| GET | /movies/{id} | Returns a movies records that contains all information known about a particular movies id. |
| GET | /movieupdates | Returns all movies ids updated since a given timestamp. |
| GET | /refresh_token | Refreshes your current, valid JWT token and returns a new token. Hit this route so that you do not have to post to /login with your API key… |
| GET | /search/series | Allows the user to search for a series based on the following parameters. |
| GET | /search/series/params | Returns an array of parameters to query by in the /search/series route. |
| GET | /series/{id} | Returns a series records that contains all information known about a particular series id. |
| GET | /series/{id}/actors | Returns actors for the given series id |
| GET | /series/{id}/episodes | All episodes for a given series. Paginated with 100 results per page. |
| GET | /series/{id}/episodes/query | This route allows the user to query against episodes for the given series. The response is a paginated array of episode records. |
| GET | /series/{id}/episodes/query/params | Returns the allowed query keys for the /series/{id}/episodes/query route |
| GET | /series/{id}/episodes/summary | Returns a summary of the episodes and seasons available for the series. Note : Season "0" is for all episodes that are considered to be spec… |
| GET | /series/{id}/filter | Returns a series records, filtered by the supplied comma-separated list of keys. |
| GET | /series/{id}/filter/params | Returns the list of keys available for the /series/{id}/filter route |
| GET | /series/{id}/images | Returns a summary of the images for a particular series |
| GET | /series/{id}/images/query | Query images for the given series ID. |
| GET | /series/{id}/images/query/params | Returns the allowed query keys for the /series/{id}/images/query route. Contains a parameter record for each unique keyType , listing values… |
| GET | /updated/query | Returns an array of series that have changed in a maximum of one week blocks since the provided fromTime . |
| GET | /updated/query/params | Returns an array of valid query keys for the /updated/query/params route. |
| GET | /user | Returns basic information about the currently authenticated user. |
| GET | /user/favorites | Returns an array of favorite series for a given user, will be a blank array if no favorites exist. |
| PUT | /user/favorites/{id} | Adds the supplied series ID to the user’s favorite’s list and returns the updated list. |
Showing 25 of 31 endpoints. The full list is in the spec above.
Buy me a coffee