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
Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.
Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.
auth: a p i k e y
find it by capability: POST /search {"query":{"text":"..."}} returns these
operations with their invocation detail. Connect any agent client.
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 `PO
| method | path | what the vendor says it does |
|---|---|---|
GET | /episodes/{id} | Returns the full information for a given episode id. __Deprecation Warning:__ The _director_ key will be depre |
GET | /languages | All available languages. These language abbreviations can be used in the `Accept-Language` header for routes t |
GET | /languages/{id} | Information about a particular language, given the language ID. Languages |
POST | /login | Returns a session token to be included in the rest of the requests. Note that API key authentication is requir |
GET | /movies/{id} | Returns a movies records that contains all information known about a particular movies id. Movies |
GET | /movieupdates | Returns all movies ids updated since a given timestamp. Movies |
GET | /refresh_token | Refreshes your current, valid JWT token and returns a new token. Hit this route so that you do not have to pos |
GET | /search/series | Allows the user to search for a series based on the following parameters. Search |
GET | /search/series/params | Returns an array of parameters to query by in the `/search/series` route. Search |
GET | /series/{id} | Returns a series records that contains all information known about a particular series id. Series |
GET | /series/{id}/actors | Returns actors for the given series id Series |
GET | /series/{id}/episodes | All episodes for a given series. Paginated with 100 results per page. Series |
GET | /series/{id}/episodes/query | This route allows the user to query against episodes for the given series. The response is a paginated array o |
GET | /series/{id}/episodes/query/params | Returns the allowed query keys for the `/series/{id}/episodes/query` route Series |
GET | /series/{id}/episodes/summary | Returns a summary of the episodes and seasons available for the series. __Note__: Season "0" is for all episo |
GET | /series/{id}/filter | Returns a series records, filtered by the supplied comma-separated list of keys. Query keys can be found at th |
GET | /series/{id}/filter/params | Returns the list of keys available for the `/series/{id}/filter` route Series |
GET | /series/{id}/images | Returns a summary of the images for a particular series Series |
GET | /series/{id}/images/query | Query images for the given series ID. Series |
GET | /series/{id}/images/query/params | Returns the allowed query keys for the `/series/{id}/images/query` route. Contains a parameter record for each |
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. Updates |
GET | /user | Returns basic information about the currently authenticated user. Users |
GET | /user/favorites | Returns an array of favorite series for a given user, will be a blank array if no favorites exist. Users |
PUT | /user/favorites/{id} | Adds the supplied series ID to the user’s favorite’s list and returns the updated list. Users |
DELETE | /user/favorites/{id} | Deletes the given series ID from the user’s favorite’s list and returns the updated list. Users |
GET | /user/ratings | Returns an array of ratings for the given user. Users |
GET | /user/ratings/query | Returns an array of ratings for a given user that match the query. Users |
GET | /user/ratings/query/params | Returns a list of query params for use in the `/user/ratings/query` route. Users |
DELETE | /user/ratings/{itemType}/{itemId} | This route deletes a given rating of a given type. Users |
PUT | /user/ratings/{itemType}/{itemId}/{itemRating} | This route updates a given rating of a given type. Users |
specification origin: https://api.thetvdb.com/swagger.json
nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.