# TVDB - For TV Shows The **TV Database (TVDB)** is a **global entertainment metadata provider** that compiles information about **TV series, episodes, and movies**. Established in **2006**, TVDB has grown into one of the most **widely used TV metadata databases**, offering information for: * **160,000+ TV series** * **300,000+ movies** * **Industry-grade metadata API** that serves **over 1 billion API calls daily** TVDB is **community-driven**, meaning users contribute data by **adding new shows, updating information, correcting errors, and suggesting improvements**. * More Details: * Create your account here: {% content-ref url="/pages/W1NRQ7PvTc3ZCNOlQMLw" %} [Add New TV Show](/how-to-use-simkl/faq/how-to-add-new-shows-missing-episodes-and-movies-to-simkl/tvdb-for-tv-shows/add-new-tv-show.md) {% endcontent-ref %} {% content-ref url="/pages/zEWX6mEX4DWBVPjBabEb" %} [Add English Translation](/how-to-use-simkl/faq/how-to-add-new-shows-missing-episodes-and-movies-to-simkl/tvdb-for-tv-shows/add-english-translation.md) {% endcontent-ref %} {% content-ref url="/pages/MuwiMANkWYmcjPfZ2ljk" %} [Add external IDs](/how-to-use-simkl/faq/how-to-add-new-shows-missing-episodes-and-movies-to-simkl/tvdb-for-tv-shows/add-external-ids.md) {% endcontent-ref %}
{% content-ref url="/pages/YGuayWNSgqBWwfWYX60K" %} [How to add new shows, missing episodes and movies to Simkl?](/how-to-use-simkl/faq/how-to-add-new-shows-missing-episodes-and-movies-to-simkl.md) {% endcontent-ref %} *** ## **Why Does SIMKL Use TVDB?** SIMKL **integrates TVDB data** to provide its users with **accurate and structured metadata** for tracking TV shows. Here’s why TVDB is essential for SIMKL: {% content-ref url="/pages/C4VwJOnffkE1aFY3BYYl" %} [TV Shows Tracking](/how-to-use-simkl/getting-started-with-simkl/basic-navigation/tv-shows-tracking.md) {% endcontent-ref %} {% content-ref url="/pages/HNAvszPodRI4ulxRReug" %} [TV Shows Filters](/how-to-use-simkl/core-features/search-and-discovery/discovering-and-exploring-with-filters/tv-shows-filters.md) {% endcontent-ref %} #### **1. Large Metadata Collection** * TVDB provides **detailed show and episode data** (air dates, cast, summaries, etc.). * Ensures **SIMKL has accurate listings** of TV series from around the world. #### **2. Structured & Consistent Data** * TVDB’s **API delivers structured metadata**. * This allows SIMKL to maintain **uniform formatting for all shows**. #### **3. Global Community Contributions** * TVDB is **user-driven**, meaning data is **continuously updated** by contributors. * Users can **submit missing information, correct errors, and improve metadata**. #### **4. TV Show Discovery** * TVDB provides **detailed categorization**, helping SIMKL users **discover related shows** based on: * Genre * Networks * Cast and crew information * Tags and metadata #### **5. Synchronization Across Multiple Platforms** * TVDB is used by many streaming services and media centers. * By using TVDB, SIMKL ensures **data consistency across platforms**. *** ## Contributing & Adding Data on TVDB The **TV Database (TVDB)** is a valuable resource for tracking and discovering TV shows from around the globe. However, just like any user-driven platform, it isn’t perfect. Data inaccuracies, missing information, and other gaps can detract from the user experience. To help address these issues, SIMKL's Moderation has filtering tools + live-updated list for necessary edits and updates that need to be made on TVDB. This guide explains **how to contribute**, **fix errors**, and **ensure accuracy** in TVDB’s database. {% hint style="success" %} SIMKL's current approach prioritizes titles that have English translations and accompanying English descriptions. For non-English, foreign-language titles, inclusion is deferred until an official or widely accepted English translation becomes available. This ensures a consistent and accessible experience for a broader audience. {% endhint %} ### **How to Help Improve TVDB Data** If you want to **fix incorrect or missing information on TVDB**, follow these steps: #### **1. Adding a New TV Show** To add a new TV show on TVDB, visit the [Add New TV Show](https://thetvdb.com/series/create) page and fill in the required details such as the show title, language, and premiere date. You can also include optional information like:, follow these steps:
1. Visit [**Add a New TV Show**](https://thetvdb.com/series/add) 2. Fill in the required fields: * **Show title** * **Language** * **Premiere date** * **Network** 3. (Optional) Add **extra details** to improve accuracy: * **Genres** * **Posters & promotional images** * **Plot summaries** * **Cast & crew details** 4. Click **"Add Series"** to save the show. 🔗 **Official Help Guide**: [**Adding TV Shows on TVDB**](https://support.thetvdb.com/kb/faq.php?cid=4) {% embed url="" %} *** #### **2. Editing Existing TV Shows** To edit the descriptions, IDs, or metadata for an existing show, navigate to the specific series page on TVDB and click the **Green button with a Gear icon > Edit**. From here, you can make changes to:
1. Navigate to the **TV show’s page on TVDB**. 2. Click the **Green "Gear" button > Edit**.
3. Update **any of the following fields**: * **Title, air dates, and episode numbers** * **IMDb, TMDB, and external links** * **Posters, trailers, and promotional content** * **Genres, cast, crew, and production details**
4. Click **“Save”** to update the show. 🔗 **Official Help Guide**: [**Editing TV Shows on TVDB**](https://support.thetvdb.com/kb/) *** #### **3. Reporting Locked or Incorrect Data** Sometimes, shows are **"locked"** on TVDB, meaning only **moderators** can edit them. If a locked show contains **incorrect information,** Provide a detailed description of the issue you believe needs to be fixed, and the TVDB support team will assist in resolving the problem:
1. Submit a **support ticket** at [**TVDB Support Portal**](https://support.thetvdb.com/kb/) 2. Provide: * **TV Show Name & Link** * **Incorrect details that need fixing** * **Official sources confirming the correct information** 3. A **TVDB moderator** will review your request. *** ### **Common Issues & Missing Data on TVDB** TVDB is a **user-driven database**, and while it provides extensive metadata on TV shows, **data gaps and inaccuracies are common**. Here are **some of the most frequent issues** that users encounter and how they can be **fixed or reported**. ### **1. Incorrect or Missing External Links & Connection IDs** TVDB establishes connections between related shows, including sequels and spin-offs. However, many of these associations are inaccurate or incomplete, leading to user confusion. Additionally, it integrates various external identifiers such as TMDB links, IMDB links, EIDR, and social media profiles.
#### **What is the issue?** * TVDB connects related **TV shows, sequels, and spinoffs** but often has **incorrect or incomplete connections**. * Many shows are missing **important external links** such as: * **IMDb** * **TMDB** * **EIDR** * **Social media pages** * **Network or official websites** #### **Why is it important?** * External links allow users to access **additional information, reviews, and cast details**. * Incorrect or missing connection IDs **disrupt proper linking** between shows, **misleading users**. 🔗 [**List of missing IMDb, TMDB, and other external links**](https://simkl.com/5743957/list/32565/) *** ### **2. Missing Posters & Cover Images**
#### **What is the issue?** Many **TV shows on TVDB** lack a proper **poster or cover image**. Some common problems include: * **No poster at all** – Some series, especially lesser-known or newly added ones, do not have a featured poster. * **Low-resolution or blurry posters** – Posters that are uploaded may not meet quality standards, appearing pixelated or unclear. * **Incorrect or outdated images** – Some posters are outdated, show wrong cast members, or feature incorrect promotional images. * **Region-specific posters missing** – Different countries have different versions of promotional posters, but TVDB often lacks these variations. * **Inconsistent poster formats** – Some entries mix fan art with official posters, leading to inconsistency. #### **Why is this important?** **1. A TV Show’s First Impression** * The **poster is the first thing viewers see** when searching for a show. * If there’s no official poster, the **show may appear incomplete or unverified**. * Proper cover images **help in attracting viewers** and making a show more recognizable. **2. Improves Show Discoverability** * Users are more likely to **click on a TV show** with an appealing cover. * Streaming platforms and media libraries rely on **consistent metadata and high-quality posters** to recommend content. * Posters help differentiate between **different versions of a show**, such as **remakes, reboots, or international versions**. **3. Increases Viewer Engagement** * Shows with **well-designed cover images** receive **more views and interactions**. * A missing poster can make a show look **unfinished or untrustworthy**. * **Updated posters keep the content fresh** for users following long-running series. **4. Consistency Across Media Platforms** * TVDB data is used by **various streaming services, media libraries, and apps**. * Having missing posters affects **how a show appears on apps like Kodi, Plex, and Simkl**. * **Complete metadata**, including high-quality posters, ensures **a consistent experience across all platforms**. #### **How to Fix Missing Posters on TVDB** If you notice that a show is missing its **poster or cover image**, here’s what you can do: **1. Check the Missing Posters List**\ This list is regularly updated with shows that **lack posters** or need **higher-quality replacements**. **2. Upload the Correct Poster** * Find an **official poster** from sources like: * IMDb * Official network websites * Press releases * High-resolution posters from streaming platforms (Netflix, Hulu, Disney+, etc.) * Make sure the **poster follows TVDB’s image guidelines**: * Proper **resolution and aspect ratio** * No **watermarks** or **unofficial modifications** * The best possible **quality (no pixelation or compression artifacts)** **3. Submit the Image on TVDB** * Visit the **TV show’s page** on TVDB. * Click **“Edit”** and navigate to the **Artwork Section**. * Upload the **official, high-quality poster**. * Provide a **source link** if required to confirm authenticity. #### **Other Media Issues That Need Fixing** Aside from missing posters, there are other **artwork and metadata issues** that affect TVDB: * [x] **Background images & wallpapers missing** – Shows should have **high-quality background images** for better display in media apps. * [x] **Logos & Clear Art missing** – Some shows **lack proper title logos**, affecting media center displays. * [x] **Banners & Promotional Art missing** – Banners are crucial for **proper UI presentation** in streaming libraries. * [x] **Cinemagraphs & Screencaps missing** – Some **animated or special art** may be absent, reducing the show’s appeal. 🔗 [**List of missing posters on TVDB**](https://simkl.com/5743957/list/32563/) *** ### **3. No IMDb or External Links (on Episodes pages)**
Direct link to the Episode Edit page: #### **What is the issue?** * **IMDb, and TMDB links** are missing for many shows and episodes. * These links **help provide cast details, ratings, reviews, and critic opinions**. #### **Why is it important?** * Without **IMDb or TMDB links**, users **have to manually search** for show details. * **Auto-updating metadata services rely on these links** to sync information. 🔗 [**List of missing IMDb links**](https://simkl.com/5743957/list/32565/) *** ### **4. Missing Plot Summaries & Translations**
#### **What is the issue?** * Many **TV shows and episodes** lack **detailed descriptions** or **plot summaries**. * Some summaries **only exist in one language**, making it difficult for international users. #### **Why is it important?** * **Plot summaries help users understand the show** before watching. * Missing descriptions make the database **less informative and harder to navigate**. 🔗 [**List of missing plot summaries**](https://simkl.com/5743957/list/32567/) *** ### **5. No Trailers or Teaser Videos**
#### **What is the issue?** * Many **TVDB entries lack official trailers, teaser videos, or preview clips**. * Some shows **have incorrect or outdated trailers**. #### **Why is it important?** * **Trailers are a key marketing tool** and help users decide whether they want to watch a show. * Missing trailers **reduce engagement and interest** in a TVDB entry. 🔗 [**List of missing trailers**](https://simkl.com/5743957/list/32569/) *** ### **6. Missing Parental Guidelines or Rating Info**
#### **What is the issue?** * Many **shows lack age ratings** like **TV-PG, TV-MA, or TV-14**. * Parental guidance information is **incomplete or missing**. #### **Why is it important?** * Parents need **content warnings** to determine **if a show is suitable for children**. * Missing ratings make it **harder to filter content for age-appropriate viewing**. 🔗 [**List of missing parental ratings**](https://simkl.com/5743957/list/32589/) *** ### **7. Incorrect or Missing Genres**
#### **What is the issue?** * Some shows are **incorrectly categorized** under the **wrong genre**. * Many TVDB entries **completely lack genre tags**. #### **Why is it important?** * **Genres help users find similar / related shows**. * A show incorrectly tagged as "Comedy" instead of "Drama" **misleads viewers**. *** ### **8. Missing Air Dates & Upcoming Release Details**
#### **What is the Issue?** One of the common problems with **TV show metadata** on TVDB is missing or **incorrect air dates** for episodes. This can happen for several reasons: 1. **Old Classic TV Shows Have Wrong Air Dates** * Many **older TV shows from the 1950s-2000s** have **incorrect premiere dates**. * Some episodes were aired **out of order** or **had lost records**, making it difficult to verify the correct air date. * In some cases, **reruns or syndicated releases** get mistaken for the original release date. 2. **New & Upcoming Indie & Regional TV Shows Forget to Update Details** * Independent, **regional TV shows, web series, and indie productions** often get **listed early** on TVDB but **fail to update their episode details** later. * Many creators **forget to add the actual air date** after initially listing the show. 3. **Episodes Get Delayed or Canceled** * Some **scheduled episodes get delayed** due to production issues, leading to **incorrect or missing release dates**. * In rare cases, an **episode may get canceled entirely**, yet TVDB may still display a **placeholder air date**. * Postponed episodes sometimes **end up airing months or years later**, requiring manual updates. 4. **Different Air Dates for Different Regions** * Shows sometimes **premiere at different times across regions**. For example: * **A show may air first in the US and later in Europe or Asia**. * **Streaming platforms may release episodes on a different schedule than cable TV**. * TVDB might list **only one region's air date**, causing confusion for international users. 5. **Special Episodes & Holiday Specials Missing Air Dates** * Holiday-themed episodes or **special one-time episodes** sometimes **lack a clear air date**. * Some **spin-offs, web episodes, and behind-the-scenes specials** may not have a recorded broadcast date, causing them to be **out of order** in the episode list. *** #### **Why Is This Important?** * [x] **Accurate air dates help users track when an episode actually aired.** * [x] **It helps users avoid confusion** when trying to watch a show in the correct order. * [x] **Streaming services and media libraries use TVDB’s data** to sort episodes chronologically—missing air dates disrupt this order. * [x] **New TV shows with missing air dates may go unnoticed** because they don’t appear in the latest release lists. * [x] **Having the correct air dates improves metadata accuracy across multiple platforms** like Simkl, Plex, Kodi, and more. *** ### **9. Incomplete Cast & Crew Listings**
**What is the issue?** One of the most common gaps in TVDB’s database is **incomplete cast and crew listings** for TV shows and movies. This includes: * **Missing guest stars, cameos, and supporting actors** – Many shows only list the main cast but leave out **recurring characters and guest appearances** that may have played a crucial role in the series. * **Lack of detailed crew information** – Directors, writers, producers, and even showrunners may be missing from certain titles. * **Voice actors missing from animated titles** – In many cases, TVDB does not list voice actors for animated shows, which makes it difficult for users looking for dubbed or original versions. * **Character roles left blank** – Even when cast members are listed, their **character names are often missing**, making it difficult to understand their role in the series. * **Old or outdated cast images** – Many actor images are either **outdated or missing entirely**, affecting visual consistency across the platform. **Why is it important?** * **Affects discoverability** – Users looking for a specific actor's **work across different projects** may not find complete results. * **Disrupts filmographies** – Many actors and crew members have incomplete profiles because their TVDB entries **lack proper crediting**. * **Essential for TV trivia & historical accuracy** – Knowing who directed, wrote, or guest-starred in a show is important for **documentary research, academic purposes, and fan discussions**. * **Impact on industry professionals** – Many industry professionals use TVDB and similar databases as references for their work history. Missing credits **affect recognition and proper documentation**. **Examples of Common Issues** * A show may **list only 5-10 main actors** while leaving out dozens of guest stars who had recurring roles. (Example: Friends Sitcom had several cameos and guest stars) * **Directors & writers missing** from some seasons or episodes, making it hard to track **who was responsible for specific episodes**. * **Dubbed & international voice actors missing**, which affects anime, animated shows, and foreign-language TV series. *** ### **10. Missing Alternative Titles & Incorrect Official Language**
**What is the Issue?** One of the major issues on TVDB is the **lack of alternative titles** for many TV shows, along with **incorrect official language labels**. These issues can lead to **confusion, difficulty in searchability, and reduced discoverability** of non-English shows. **Common Issues Related to Titles and Language:** 1. **Missing Alternative Titles:** * Some shows only list their **English title**, failing to include **regional or translated titles**. * Example: A English TV drama may only list the English title, making it **difficult for native regional speakers to find it**. * Some anime and K-Dramas are known by **different names across regions**, but those names are not listed. 2. **Incorrect Official Language Labels:** * The **primary language of the show is sometimes mislabeled**, which can **mislead users** who search for content based on language. * Example: A French series might be mistakenly listed as English due to **a translation being available**. 3. **Lack of Proper Aliases:** * Some TV shows have **multiple names** in **different languages or regions**, but TVDB only lists **one name**. * Example: * **Original Title:** 长相思 * **English Title:** *Lost You Forever* * **Alias Titles:** *Eternal Love: The Longest Promise* (alternate translation) 4. **Incomplete Localization for Searchability:** * Users from **different countries** often **search using different spellings or translations**. * Without proper aliasing, **users may not find their desired show**. * If a show **only has English translation**, users **can add their own** translation in their native language. *** #### **Why is It Important?** * [x] **Better Discoverability** – Adding alternative titles improves search results, helping international users find shows. * [x] **More Accurate Show Listings** – Correcting the official language ensures **content is properly categorized**. * [x] **Enhanced Localization** – Translations make it easier for **non-English speakers** to browse shows in their native language. * [x] **Reduces Duplicate Entries** – Users often add duplicate listings when they can’t find a show under the name they know. *** ### **11. No User Ratings or Viewer Scores**
**What is the issue?** * Some TV shows **don’t have user ratings enabled**, meaning **there’s no score data available**. * Many shows **lack user reviews**, making it difficult for new viewers to gauge the show's quality. * Some underrated shows are **widely watched but never rated**, keeping them in obscurity. * **Absence of ratings can also indicate missing data**, such as: * **No genres assigned** * **Wrong or incomplete metadata** * **Duplicate or inconsistent entries** * **Lack of trailers or teaser videos** * **Incomplete tags or keywords** **Why is this important?** * **Ratings help users decide whether a show is worth watching.** * A well-rated show is **more likely to attract attention** than one with no reviews. * **Underrated shows often get lost in the database** due to a lack of engagement. * Many hidden gems go unnoticed because **viewers forget to rate or review them**. * **A show with no ratings might indicate data issues.** * Sometimes, shows **lack ratings because they are misclassified, missing important metadata, or have duplicate entries**. * **Adding reviews and ratings benefits the entire community.** * By sharing opinions and feedback, users help **improve show discoverability and enhance recommendations**. **How can users help?** * **Rate and review underrated shows** to give them the visibility they deserve. * **Report missing or incorrect data** (wrong genres, missing tags, incomplete descriptions). * **Contribute trailers or teaser links** for better engagement. * **Encourage other viewers to rate & review shows** to create a more balanced and informative database. 🔗 [List of all titles with No User ratings](https://simkl.com/5743957/list/83975/tvdb-tv-shows-moderation-list-no-user-ratings) *** ### **12. Incomplete or Missing Episode Guides**
#### **What is the issue?** * Many **TV series lack complete episode guides**. * Some episodes are **incorrectly numbered or missing descriptions**. #### **Why is it important?** * A **complete episode guide** helps users track which episodes they’ve watched. * Missing episodes **cause confusion when browsing a show’s history**. 🔗 [List of titles with lack of Episode data](https://simkl.com/5743957/list/83941/tvdb-tv-shows-moderation-list-no-episode-info) *** ### **13. Missing Awards & Nominations**
#### **What is the Issue?** Many TV shows and episodes on TVDB are **missing critical award information**, including: * **Major wins and nominations** from global and regional award bodies. * **Lack of recorded nominees** for prestigious awards such as the **Emmys, BAFTAs, Critics' Choice, Golden Globes**, and more. * **Incorrect or incomplete award details**, such as missing categories, winning years, or associated cast/crew members. #### **Why is This Important?** 1. **Increases Show Discoverability** * Many viewers look for **critically acclaimed** or **award-winning** TV shows. * Missing awards prevent shows from getting **the recognition they deserve**. 2. **Encourages Viewers to Watch Underrated Shows** * Award-winning but lesser-known shows remain **hidden** without proper tagging. * Users often **binge-watch** past winners, and missing data prevents this discovery. 3. **Enhances the Accuracy of TVDB’s Database** * TVDB aims to be a **comprehensive metadata source** for TV content. * Without awards, the site lacks **important credibility markers** for shows. #### **How to Improve Award Data on TVDB** 1. **Adding Missing Awards** * Users can contribute by **checking major award events** and adding relevant data. * Make sure to include: * Award Name (e.g., **BAFTA Awards, Golden Globes**) * Category (e.g., **Best Drama Series**) * Year of Award * Winner or Nominee Status * Individual (if applicable, e.g., **Best Lead Actor**) 2. **Cross-Checking Award Data** * TVDB contributors should **verify awards from official sources** like: * IMDb * Official Award Websites (Oscars, Emmys, etc.) * News Articles 3. **Encouraging More Users to Rate and Review** * Some shows may have won awards, but **lack user reviews or ratings**. * Users should **rate, review, and contribute** missing details to help others find quality content. 4. **Reporting Incorrect Awards** * If a show has the **wrong award category or year**, users should **report it to TVDB moderators** for correction. #### **How Can Users Benefit From Award Information?** * Viewers can **discover top-tier content** through award recognition. * Awards help users find **the best-rated shows** from previous years. * **Streaming services and curators** use award data to feature top-rated shows. By contributing and improving the award information on TVDB, users help **build a richer, more reliable database** that enhances TV discovery for everyone! *** ### **14. Inaccurate Running Times**
#### **What is the issue?** * Some shows **list incorrect episode runtimes**. * Many episodes **have no runtime listed at all**. * Many **TV shows and episodes information**. * Some shows **list incorrect or average durations** instead of actual episode times. #### **Why is it important?** * Users **need to know how long an episode is** before committing to watching. * **Incorrect durations affect content organization**. * Accurate **running times help users plan their viewing schedules**. 🔗 [List of TV Show titles with No Running Time Episode information](https://simkl.com/5743957/list/83929/tvdb-tv-shows-moderation-list-no-running-time) *** ### 15. No Language Info
**What is the Issue?** Many TV shows on TVDB do not specify **the original language** they aired in. This makes it difficult for: * **Non-English users** to find content in their **native language**. * Search engines to **filter content by language**. * Localization efforts, as **translations become harder to manage**. **Example of the Issue:** * A **Korean drama** might be missing **"Korean"** as the original language. * An **anime series** could be mistakenly labeled as **English**, even though it originally aired in **Japanese**. **How to Fix It?** * Check official sources (**network websites, streaming platforms, or production studios**) to verify the **original broadcast language**. * Update the **correct language metadata** in TVDB to **reflect the original airing language**. * If the show **already has an English translation**, consider adding **translations in other languages** for **localization**. **Why It Matters?** * Helps **global users find content** in their **preferred language**. * Improves **search accuracy** when filtering by language. * Supports **better content organization** on TVDB. 🔗 [List of all TV Shows with No Language Info](https://simkl.com/5743957/list/83947/tvdb-tv-shows-moderation-list-no-language-info) *** ### 16. No Country Info
**What is the Issue?** Many shows are **missing their country of origin**, making it difficult to: * Filter shows **by region or production country**. * Distinguish between **local vs. international productions**. * Identify **co-productions** that span **multiple countries**. **Example of the Issue:** * A **Spanish show** produced by Netflix may be incorrectly listed as **"United States"** instead of **"Spain"**. * A **Japanese anime series** may be missing **"Japan"** as the production country. **How to Fix It?** * Confirm the **official production country** through **trusted sources**. * If the show is a **co-production**, list all relevant **countries** involved. **Why It Matters?** * Allows users to **search for content by country**. * Helps **regional audiences find local content**. * Improves **accuracy in TV listings**. 🔗 [List of all TV Shows with No Country Info](https://simkl.com/5743957/list/83943/tvdb-tv-shows-moderation-list-no-country-info) *** ### 17. Lack of Tags, Subgenre & Keywords
**What is the Issue?** Many shows are only assigned **broad genres** like "Drama" or "Comedy" but **lack specific subgenres or keywords**. This makes **niche content harder to find**. **Examples of Missing Subgenres:** * **Supernatural Thriller** instead of just "Thriller". * **Historical Romance** instead of just "Romance". * **Political Drama** instead of just "Drama". **How to Fix It?** * Add **specific subgenres** that describe the show **more accurately**. * Include **important keywords** related to themes or settings. * Example: **"Time Travel," "Dystopian," "Courtroom Drama"**. * Use **official descriptions** to determine **additional relevant tags**. **Why It Matters?** * Improves **search results** for users. * Provides **more relevant recommendations**. * Helps viewers **discover niche content**. *** ### 18. Inspiration & Adaptation Links
**What is the Issue?** Some TV series are **adaptations** of **books, comics, historical events, or video games**, but TVDB does not always list **links to the source material**. **Examples of Missing Adaptation Data:** * **Books & Novels:** *The Witcher* (based on Andrzej Sapkowski’s books). * **Comics & Graphic Novels:** *The Boys* (based on the comic series). * **Historical Events:** *Chernobyl* (based on real-life nuclear disaster). * **Video Games & Other Media:** *The Last of Us* (based on the PlayStation game). **How to Fix It?** * Add **official source links** to: * **Goodreads** (for books & novels). * **Grand Comics Database** (for comics). * **Wikipedia** (for historical events). * Ensure **fictional adaptations** are correctly **categorized**. **Why It Matters?** * Helps **users explore source material**. * Allows fans to **find adaptations** more easily. * Improves **cross-referencing between media types**. {% embed url="" %} *** ## **Reporting & Editing Data on TVDB** If you find **incorrect or missing data** on TVDB, follow these steps: ### **1. Fixing Data Yourself** If a show **is not locked**, follow these steps: 1. **Go to the TV show’s page** on TVDB. 2. **Click the Edit button** (Green "Gear" icon). 3. **Update missing information**: * Add a **poster** * Update the **plot summary** * Add **IMDb & TMDB links** * Correct **episode air dates** 4. Click **“Save”**. *** ### **2. Reporting Locked or Uneditable Shows** If a show **is locked**, or contains **incorrect data that you can't edit**, report it: 1. **Submit a ticket on TVDB Support**:\ 🔗 [**TVDB Help Center**](https://support.thetvdb.com/kb/) 2. Provide: * TV Show **name & link** * Incorrect **details that need fixing** * **Official sources** confirming the correct information *** ### **3. Requesting a Feature on TVDB site or API** Want to suggest a **new feature or improvement** for TVDB? * Visit [**TVDB Feature Requests**](https://feedback.userreport.com/cdaca6ba-2142-4b27-b04d-26ceaa067824/)**:** [**https://feedback.userreport.com/cdaca6ba-2142-4b27-b04d-26ceaa067824/#ideas/popular**](https://feedback.userreport.com/cdaca6ba-2142-4b27-b04d-26ceaa067824/#ideas/popular) *** ## **How to Earn Points for Your Contributions** When you help improve records on TVDB by submitting valid data from other sources, your submission will be reviewed and validated by TVDB moderators.
Once approved, your contribution will earn you points. The more you contribute, the more points you accumulate, allowing you to rise up the **Global Leaderboard**.
* **Moderators review and approve your submission**. * **You earn points** for contributing. * **Top contributors get rewards**, including **a free year of TVDB Premium**. 🔗 **Learn more here**: *** ## **Frequently Asked Questions (FAQs)** #### **1. I’ve added a new show to TVDB. When will it appear on SIMKL?** Once you add a show to **TVDB**, SIMKL **automatically syncs updates** within **24 to 48 hours**. However, if the update is delayed: * Check **if TVDB has processed the show correctly**. * Ensure the show **is not locked** (locked shows require moderator approval). #### **2. How long does it take for TVDB updates to appear on SIMKL?** * **Minor updates** (titles, descriptions, air dates) typically take **24 to 48 hours**. * **Major changes** (adding a new show) may take **up to 72 hours**. * **Locked or incomplete entries** may experience delays. #### **3. What if TVDB displays a show as locked or has incorrect episode information?** * If a **TV show is locked**, only **TVDB moderators** can edit it. * To **correct mistakes**, submit a **mod request on TVDB’s support forums**. * For **feature suggestions or reporting incorrect data**, visit [**TVDB Feedback Portal**](https://feedback.userreport.com/cdaca6ba-2142-4b27-b04d-26ceaa067824/). #### **4. How can I become a moderator on TVDB?** If you’d like to become a **TVDB moderator**, you need to pass an **official assessment test** and meet specific contribution criteria: 1. Take the **TVDB Moderator Test** here: [**TVDB Moderator Application**](https://forms.gle/r9Aogm42kbZaWsJo6) 2. Your **history of edits, forum activity, and ticket responses** will be reviewed. 3. If approved, you will gain **moderation privileges** on TVDB. More Details: #### **5. How do I report missing or incorrect data on TVDB?** If you find **missing or incorrect information on TVDB**, follow these steps: 1. **Check if the show is locked** – If locked, submit a **TVDB mod request**. 2. **Submit missing data manually** – Update the entry directly on TVDB. 3. **Report persistent issues** via TVDB’s **support forums** or **help desk**. #### **6. Where can I suggest improvements to the TVDB website or features?** To suggest **new features or site improvements**, submit your ideas here:\ 🔗 [**TVDB Feature Requests**](https://feedback.userreport.com/cdaca6ba-2142-4b27-b04d-26ceaa067824/) *** ## **Everything You Need to Know About TVDB API** The **TV Database (TVDB) API** is a powerful tool that allows developers, businesses, and individuals to access a vast library of TV show metadata, movie details, and related media information. The API enables applications to fetch essential data like **episode guides, cast and crew details, show descriptions, images, and more**. ### **What is the TVDB API?** The TVDB API is a **RESTful API** designed for use by developers to integrate TV and movie data into their applications. This API provides access to an extensive database containing: * [x] TV Shows & Episode Listings * [x] Movie Metadata * [x] Cast & Crew Information * [x] Show & Movie Posters * [x] Streaming Information * [x] Translations in Multiple Languages * [x] Ratings & Reviews TVDB’s API is **widely used by media centers, streaming platforms, and TV tracking apps** like **SIMKL, Kodi, and others**. *** ### **How to Get a TVDB API Key?** To get access to TVDB’s API, follow these steps:
1. **Sign up on TVDB**: * Go to [TheTVDB](https://www.thetvdb.com/) * Create an account or log in. 2. **Navigate to API Subscription**: * Click on your profile. * Select **"API Subscription"** from the dropdown menu. 3. **Choose a Subscription Plan**: * Select **Free, Commercial, or Enterprise** based on your usage needs. 4. **Generate API Key**: * Once subscribed, TVDB provides a unique **API Key** under the "Manage API Services" section. 5. **Use the API Key**: * Integrate this key into your application following the official [TVDB API documentation](https://github.com/thetvdb/v4-api). {% embed url="" %} *** ### **Can You Get the TVDB API for Free?** Yes, **TVDB offers a free API plan** for non-commercial projects, but with limited features. Here’s a breakdown of available plans: | **Company Revenue** | **Licensing Fee** | | ----------------------- | ------------------------------- | | Less than $50k per year | **Free** (Requires Attribution) | | $50k to $250k per year | **$1,000 per year** | | $250k to $1M per year | **$10,000 per year** | | $1M+ or Custom Terms | **Contact TVDB Sales** | * **Free API Access**: Requires proper attribution (crediting TVDB as a data source). * **Paid API Access**: Offers higher API limits, commercial usage rights, and priority support. For more details, visit the [**TVDB API Subscription page**](https://www.thetvdb.com/api-information). *** ### **How to Find a TVDB ID?** Each **TV show, movie, season, and episode on TVDB** has a unique ID, which can be found using: 1. **Search TVDB**: * Go to [**TVDB Search**](https://www.thetvdb.com/). * Enter the title of the movie or TV show. * Click on the correct entry. 2. **Check the URL**: * The TVDB ID is located in the URL. * Example: `https://www.thetvdb.com/series/12345` → **TVDB ID = 12345**. 3. **Use the API**: * Fetch data programmatically using the **API search endpoint**. * Example: `https://api.thetvdb.com/search/series?name=Breaking+Bad` *** ## Few Issues on TVDB, that Also Effects SIMKL TVDB serves as one of the **primary metadata providers** for SIMKL, but it has **few limitations** that affect **accuracy, usability, and data completeness**. Below are some of the few **issues with TVDB** that may indirectly impact SIMKL and **its users**. *** ### **1. Lack of Support for Asian TV Shows & Films (K-Dramas, C-Dramas, Turkish Dramas, etc.)** **What is the Issue?** TVDB **lacks proper support for regional Asian content**, especially: * **Korean Dramas (K-Dramas)** * **Chinese Dramas (C-Dramas)** * **Japanese Dramas (J-Dramas)** * **Turkish Dramas** * **Thai & Other Asian TV Shows** Many of these **popular shows are missing** or **incomplete**, making it **difficult for international viewers** to track them. **How It Affects?** * **K-Dramas & C-Dramas are often missing** or **lack proper metadata**. * **No accurate episode lists** for long-format Asian dramas. * Users **cannot properly track Asian TV content**. **Solution:** TVDB **must expand its metadata support** for **Asian TV Shows & Films**. *** ### **2. Lack of More Regional Award Types in Award Section** **What is the Issue?** TVDB has **very limited award categories**, making it difficult to track **important accolades** such as: * **Golden Globe Awards** * **BAFTA Awards** * **Asian Drama Awards** * **Anime-Specific Awards** *(e.g., Crunchyroll Anime Awards)* Currently, **many award-winning TV shows lack proper recognition** due to **missing award categories**. **How It Affects?** * Users **cannot filter shows by regional award wins**. * Anime & regional dramas **are underrepresented** in award listings. * **TV series metadata feels incomplete** without award recognition. **Solution:** TVDB **must introduce more award categories** to properly credit **global TV and anime content**. *** ### **3. Several Anime & Asian Dramas Are Still Missing on TVDB** **What is the Issue?** TVDB **has an incomplete library of anime & Asian dramas**, meaning **many titles do not exist on the platform**. Examples: * **Ongoing seasonal anime** often **go missing**. * **Older anime classics** do not have **proper episode data**. * **Popular K-Dramas & C-Dramas are not indexed properly**. **How It Affects?** * Users **cannot add missing shows** to their watchlists. * **Tracking watch progress for anime & Asian content becomes impossible**. * **Delays in adding new episodes** make SIMKL updates inconsistent. **Solution:** TVDB **must regularly update its database** to **include ALL major anime & Asian dramas**. *** ### **4. Lack of Character Information for Older TV Shows** **What is the Issue?** TVDB **often lacks character bios and cast details** for **older TV shows**. Common Issues: * **No character descriptions** for **classic series**. * **Missing cast images** or outdated photos. * **No voice actor data** for animated shows. **How It Affects?** * **Users cannot identify characters easily**. * **Incomplete cast lists** for **retro TV shows**. * **Anime voice actors are missing**, making **searching difficult**. **Solution:** TVDB **must improve character metadata** for **older and animated shows**. *** ### **5. Popular Shows Get Mod-Locked, Making Updates Difficult** **What is the Issue?** Many **popular TV shows** on TVDB get **locked by moderators**, preventing **quick updates**. Examples: * **Game of Thrones** * **Breaking Bad** * **Attack on Titan** * **One Piece** Because of the **mod lock**, **users cannot fix errors** in these popular series, leading to **delays in updating information**. **How It Affects?** * **Delays in new episode additions**. * **Incorrect information stays locked** for months. * Users **get frustrated due to lack of updates**. **Solution:** TVDB **must improve the moderation system** and **allow faster updates for locked content**. *** ## **Conclusion** TVDB is **one of the most important metadata providers** for TV tracking platforms like SIMKL. While it provides **rich TV show data**, it **relies heavily on user contributions**. **By contributing to TVDB, you help improve TV tracking for everyone.** Whether it’s **adding missing posters, fixing incorrect IDs, or reporting locked shows**, your contributions make TVDB a more **accurate and reliable platform**. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.simkl.org/how-to-use-simkl/faq/how-to-add-new-shows-missing-episodes-and-movies-to-simkl/tvdb-for-tv-shows.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.