Overview
TheTVDB API is the go-to source for television metadata, covering series, seasons, episodes, actors, and artwork. It powers many popular media center apps and is continually updated by a large community. You need to register for a free API key at thetvdb.com to access the data.
Beginner Tip
Authenticate first by posting your credentials to /login to receive a JWT token, then use that token in the Authorization header for all subsequent requests. Start with /series/search to find shows by name.
Available Data
Example Response
{
"status": "success",
"data": {
"result": "Data from TVDB",
"description": "Television data",
"timestamp": "2025-01-15T10:00:00Z"
}
} Field Reference
id Unique TVDB identifier for the series or episode. name Official name of the TV series. overview Plot summary or description of the series. status Current broadcast status, such as Continuing or Ended. firstAired Date the series first aired in YYYY-MM-DD format. image URL path to the series poster image on TVDB. Implementation Example
const url = "https://thetvdb.com/api-information";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Partially tested on Apr 5, 2026
Technical Specifications
Similar APIs
View All →IMDb-API
IMDb-API provides programmatic access to api for receiving movie, serial and cast information via REST API.
JSON2Video
JSON2Video API lets you create and edit videos programmatically by sending a JSON payload that describes scenes, text animations, voice-overs, watermarks, and slideshows.
Open Movie Database
⭐ Beginner's PickThe Open Movie Database (OMDb) API lets you search for movies, TV shows, and episodes by title or IMDb ID.
Simkl
Simkl is a tracking service for movies, TV shows, and anime that also exposes a developer API.
The Lord of the Rings
The One API provides comprehensive data from J.R.R.