CINXE.COM
API - TheTVDB.com
<!DOCTYPE html> <html lang="en"> <head> <!-- Google tag (gtag.js) --> <script async src="https://www.googletagmanager.com/gtag/js?id=G-E35MMLRF5R"></script> <script> window.dataLayer = window.dataLayer || []; function gtag() { dataLayer.push(arguments); } gtag('js', new Date()); gtag('config', 'G-E35MMLRF5R'); gtag('set', 'user_properties', { userid: '0', user_role: 'guest', user_subscribed: 'no', }); </script> <title>API - TheTVDB.com</title> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="robots" content="max-image-preview:large"> <meta name="csrf-token" content="yYUHnafZnVhdu23kDeeFO7MISJhP3QEdj1Ss9bVM"> <link rel="icon" type="image/png" href="/images/icon.png"> <link rel="apple-touch-icon" href="/apple-touch-icon.png" /> <link rel="apple-touch-icon" sizes="57x57" href="/apple-touch-icon-57x57.png" /> <link rel="apple-touch-icon" sizes="72x72" href="/apple-touch-icon-72x72.png" /> <link rel="apple-touch-icon" sizes="76x76" href="/apple-touch-icon-76x76.png" /> <link rel="apple-touch-icon" sizes="114x114" href="/apple-touch-icon-114x114.png" /> <link rel="apple-touch-icon" sizes="120x120" href="/apple-touch-icon-120x120.png" /> <link rel="apple-touch-icon" sizes="144x144" href="/apple-touch-icon-144x144.png" /> <link rel="apple-touch-icon" sizes="152x152" href="/apple-touch-icon-152x152.png" /> <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon-180x180.png" /> <link rel="icon" type="image/png" sizes="196x196" href="/touch-icon-196x196.png"> <link rel="stylesheet" href="/build/css/app-4598045a34.css"> <link rel="stylesheet" href="/build/css/all-b2a0e80364.css"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-select@1.13.14/dist/css/bootstrap-select.min.css"> <link href='https://fonts.googleapis.com/css?family=Noto+Sans:400,700&subset=latin,cyrillic-ext,latin-ext,cyrillic,greek-ext,greek,devanagari,vietnamese' rel='stylesheet' type='text/css'> <link href='https://fonts.googleapis.com/css?family=Tangerine:400,700' rel='stylesheet' type='text/css'> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" integrity="sha512-SfTiTlX6kk+qitfevl/7LibUOeJWlt9rbyDn92a1DqWOw9vWG2MFoays0sgObmWazO5BQPiFucnnEAjpAB+/Sw==" crossorigin="anonymous" referrerpolicy="no-referrer" /> <script src="https://adncdn.net/fnsigjd2" async></script> <script async src="https://fundingchoicesmessages.google.com/i/pub-9638751259933291?ers=1" nonce="gQ4GblrDkNyTsj-yS8jxnw"></script> <script nonce="gQ4GblrDkNyTsj-yS8jxnw"> (function() { function signalGooglefcPresent() { if (!window.frames['googlefcPresent']) { if (document.body) { const iframe = document.createElement('iframe'); iframe.style = 'width: 0; height: 0; border: none; z-index: -1000; left: -1000px; top: -1000px;'; iframe.style.display = 'none'; iframe.name = 'googlefcPresent'; document.body.appendChild(iframe); } else { setTimeout(signalGooglefcPresent, 0); } } } signalGooglefcPresent(); })(); </script> <script> // Define googlefc and the controlled messaging function on the Window. window.googlefc = window.googlefc || {}; googlefc.controlledMessagingFunction = async (message) => { const isSubscriber = false; if (isSubscriber || false || false) { message.proceed(false); } else { message.proceed(true); } } </script> </head> <body id="app"> <div id="ATF"></div> <div class="navbar navbar-default main_navigation" role="navigation"> <div class="container"> <div style="display:flex"> <div> <a href="/" class="navbar-brand"><img alt="TheTVDB.com" src="/images/logo.svg"></a> </div> <div style="flex-grow: 3"> <div class="navbar-header"> <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <div class="collapse navbar-collapse"> <ul class="nav navbar-nav"> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Discover</a> <ul class="dropdown-menu"> <li><a href="/on-today">On Today</a></li> <li><a href="/awards">Awards</a></li> <li><a href="/companies">Companies</a></li> <li><a href="/lists">Lists</a></li> <li><a href="/people">People</a></li> <li><a href="/taxonomy">Tagging & Taxonomy</a></li> </ul> </li> <li><a href="/points" onclick="ga('send', 'event', 'gamification_link', 'header');">Earn Points</a></li> <li><a href="http://support.thetvdb.com" target="_blank">Support</a></li> <li class="dropdown hidden-sm hidden-md hidden-lg showauth-user"> <a href="#" class="dropdown-toggle" data-toggle="dropdown"> <i class="fa fa-plus-circle" aria-hidden="true" style="margin-right:10px"></i> Add A Record </a> <ul class="dropdown-menu"> <li><a href="/series/create">Add Series</a></li> <li><a href="/movies/create">Add Movie</a></li> <li><a href="/people/create">Add Person</a></li> </ul> </li> <li class="dropdown hidden-sm hidden-md hidden-lg showauth-user"> <a href="#" class="dropdown-toggle" data-toggle="dropdown"> <i class="fa fa-user-circle" aria-hidden="true" style="margin-right:10px"></i> Account </a> <ul class="dropdown-menu"> <li><a href="/dashboard">Dashboard</a></li> <li><a href="/dashboard/notifications">Notifications</a></li> <li><a href="/subscribe">Subscribe</a></li> <li><a href="/dashboard/favorites/series">Favorite Series</a></li> <li><a href="/dashboard/favorites/movies">Favorite Movies</a></li> <li><a href="/logout">Logout</a></li> </ul> </li> <li class="hidden-lg hidden-md hidden-sm showauth-guest"><a href="/auth/login?redirect=api-information"><i class="fa fa-user-circle" aria-hidden="true" style="margin-right:10px"></i> Login</a> </li> </ul> </div> <a href="/search" class="mobile-search hidden-sm hidden-md hidden-lg"><i class="fa fa-search" aria-hidden="true"></i></a> </div> </div> <div class="hidden-xs"> <ul class="nav navbar-nav navbar-right"> <li class="hidden-md hidden-lg"><a href="/search"><i class="fa fa-search" aria-hidden="true"></i></a></li> <li class="dropdown showauth-user"> <a href="#" class="dropdown-toggle" data-toggle="dropdown" title="Add A Record"> <i class="fa fa-plus-circle" aria-hidden="true"></i> </a> <ul class="dropdown-menu"> <li><a href="/series/create">Add Series</a></li> <li><a href="/movies/create">Add Movie</a></li> <li><a href="/people/create">Add Person</a></li> </ul> </li> <li class="dropdown showauth-user"> <a href="#" class="dropdown-toggle user-menu" data-toggle="dropdown"> <i class="fa fa-user-circle" aria-hidden="true"></i> <span id="notification-icon"></span> </a> <ul class="dropdown-menu"> <li><a href="/dashboard">Dashboard</a></li> <li><a href="/dashboard/notifications">Notifications <span id="notification-indicator"></span></a></li> <li><a href="/subscribe">Subscribe</a></li> <li><a href="/dashboard/favorites/series">Favorite Series</a></li> <li><a href="/dashboard/favorites/movies">Favorite Movies</a></li> <li><a href="/logout">Logout</a></li> </ul> </li> <li class="showauth-guest"> <a href="/auth/login?redirect=api-information">Login</a> </li> </ul> <form action="/search" method="get" class="navbar-form navbar-left hidden-xs hidden-sm" autocomplete="off"> <input type="text" name="query" class="form-control" placeholder="Search TheTVDB"> </form> </div> </div> </div> </div> <div class="container"> <div class="page-toolbar"> <div class="crumbs"> <a href="/">Home</a> / Developers / </div> <h1>API and Data Licensing</h1> </div> <div class="flash-message"> </div> <p>Thousands of projects, companies, and individuals make use of the data that is available in our API, from large-scale commercial projects/companies to individual end users who contribute data to the site to power their media centers and applications. Our API is available for both commercial projects and to individual developers.</p> <div class="tvdb-tabs mt-2" role="tablist"> <div role="presentation" class="active"><a href="#general"role="tab" data-toggle="tab">Pricing</a></div> <div role="presentation"><a href="#documentation"role="tab" data-toggle="tab">Documentation & Assistance</a></div> <div role="presentation"><a href="#attribution" role="tab" data-toggle="tab">Attribution</a></div> <div role="presentation"><a href="#legal" role="tab" data-toggle="tab">Legal Usage</a></div> </div> <div class="tab-content"> <div role="tabpanel" class="tab-pane active" id="general"> <div class="row"> <div class="col-xs-12"> <p>TheTVDB relies on contributed information from tens of thousands of users, many using free and open source software that uses our API. In order to ensure the ongoing quality of our data, we offer significant discounts for these projects.</p> <p>When determining your tier, please consider the revenue of your parent company. It is your responsibility to ensure that you select the correct tier, and make annual adjustments as necessary.</p> </div> </div> <div class="row"> <div class="col-xs-12"> <table class="table table-bordered mt-1"> <thead> <tr> <th width="60%">Company Revenue</th> <th width="40%" class="text-center">Licensing Fee</th> </tr> </thead> <tbody> <tr> <td>Less than $50k per year</td> <td class="text-center" style="font-size:15pt"> <strong>free</strong> <div style="font-size:9pt">requires attribution</div> </td> </tr> <tr> <td>$50k to $250k per year</td> <td class="text-center" style="font-size:15pt"> <strong>$1,000 / year</strong> </td> </tr> <tr> <td>$250k to $1M per year</td> <td class="text-center" style="font-size:15pt"> <strong>$10,000 / year</strong> </td> </tr> <tr> <td>$1M+ or custom terms</td> <td class="text-center"><a href="mailto:sales@whipmedia.com">Contact Us</a></td> </tr> </tbody> </table> <div class="text-center mt-2"> <a href="/api-information/signup" class="btn btn-lg btn-primary">Get Started</a> </div> </div> </div> </div> <div role="tabpanel" class="tab-pane" id="documentation"> <p>Our <a href="https://github.com/thetvdb/v4-api" target="_blank">GitHub repo</a> is your launchpad to the API documentation, official libraries, and release notes. Issues related to the API itself should be reported on the repo, and issues related to any libraries should be reported directly on those. If you need support with the site itself, or the data contained within, please use our <a href="https://support.thetvdb.com" target="_blank">end user support portal</a>.</p> </div> <div role="tabpanel" class="tab-pane" id="attribution"> <p>Unless approved by TheTVDB, attribution with a direct link to TheTVDB.com must be displayed to end users viewing metadata from our API. Command line products or development libraries may display attribution on your about or readme pages.</p> <h3>Sample Attribution</h3> <style> .thetvdbattribution { display: flex; margin: 5px 0; padding: 15px; background-color: #365658; border: 1px solid #0d1313; min-height: 80px; align-items: center; justify-content: center; font-size: 13px; } .thetvdbattribution:hover { background-color: #406264; } .thetvdbattribution img { margin: 0 10px 0; } </style> <div style="max-width: 500px"> <a class="thetvdbattribution" style="" href="https://thetvdb.com/subscribe"> <img src="/images/attribution/logo1.png" height="45"> Metadata provided by TheTVDB. Please consider adding missing information or subscribing. </a> </div> <h3 class="mt-4">Brand Logos</h3> <div class="row"> <div class="col-xs-6 col-sm-3"> <img src="/images/attribution/logo1.png" class="img-responsive thumbnail" style="background-color: #1b2626; border: #999; padding: 15px; border-radius: 8px"> </div> <div class="col-xs-8 col-sm-3"> <img src="/images/attribution/logo2.png" class="img-responsive thumbnail" style="background-color: #fff; border: #999; padding: 15px; border-radius: 8px"> </div> </div> </div> <div role="tabpanel" class="tab-pane" id="legal"> <p>We do not claim ownership of any of the images or data in the API. We comply with the Digital Millennium Copyright Act (DMCA) and expeditiously remove infringing content when properly notified. Any data and/or images you upload you expressly grant us a license to use. You are prohibited from using the images and/or data in connection with libelous, defamatory, obscene, pornographic, abusive or otherwise offensive content.</p> </div> </div> </div> <div id="Bottom"></div> <footer class="footer"> <div class="container"> <div class="row"> <div class="col-xs-12 col-sm-3"> <h5>About</h5> <ul class="list-unstyled"> <li><a href="/about">About TheTVDB</a></li> <li><a href="/points" onclick="ga('send', 'event', 'gamification_link', 'footer');">Earn Points</a></li> <li><a href="/subscribe">Subscribe</a></li> <li><a href="/api-information">API</a></li> <li><a href="https://feedback.userreport.com/cdaca6ba-2142-4b27-b04d-26ceaa067824/" target="_blank">Feature Suggestions</a></li> <li><a href="https://support.thetvdb.com/kb/" target="_blank">Knowledgebase</a></li> <li><a href="http://support.thetvdb.com" target="_blank">Support</a></li> </ul> </div> <div class="col-xs-12 col-sm-3"> <h5>Discover</h5> <ul class="list-unstyled"> <li><a href="/on-today">On Today</a></li> <li><a href="/awards">Awards</a></li> <li><a href="/companies">Companies</a></li> <li><a href="/lists">Lists</a></li> <li><a href="/people">People</a></li> <li><a href="/taxonomy">Taxonomy</a></li> </ul> </div> <div class="col-xs-12 col-sm-3"> <h5>Legal</h5> <ul class="list-unstyled"> <li><a href="/tos">Terms of Service</a></li> <li><a href="/privacy-policy">Privacy Policy</a></li> <li><a href="/dmca">DMCA</a></li> </ul> </div> <div class="col-xs-12 col-sm-3"> <h5>Follow Us</h5> <a target="_blank" href="https://www.facebook.com/TheTVDB" class="footer-social"> <span class="fa-stack fa-lg"> <i class="fa fa-circle fa-stack-2x"></i> <i class="fa fa-facebook fa-stack-1x fa-inverse"></i> </span> </a> <a target="_blank" href="https://twitter.com/thetvdb" class="footer-social"> <span class="fa-stack fa-lg"> <i class="fa fa-circle fa-stack-2x"></i> <i class="fa fa-twitter fa-stack-1x fa-inverse"></i> </span> </a> </div> </div> <div class="row mt-2"> <div class="col-xs-12"> <a href="/"><img alt="TheTVDB.com" src="/images/logo_footer.svg" class="footer-logo" height="40"></a> © 2025 TheTVDB.com ®, A Whip Media Company. ALL RIGHTS RESERVED. </div> </div> </div> </footer> <script> window.auth = ''; window.auth_language = 'eng'; window.user_unique = null; </script> <script src="/build/js/vendor-28929ee939.js"></script> <script src="https://cdn.jsdelivr.net/npm/instantsearch.js@3.5.3"></script> <script src="https://cdn.jsdelivr.net/npm/algoliasearch@3.32.0/dist/algoliasearchLite.min.js"></script> <script src="https://cdn.jsdelivr.net/autocomplete.js/0/autocomplete.jquery.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/bootstrap-select@1.13.14/dist/js/bootstrap-select.min.js"></script> <script src="https://unpkg.com/react@17.0.2/umd/react.production.min.js" crossorigin></script> <script src="https://unpkg.com/react-dom@17.0.2/umd/react-dom.production.min.js" crossorigin></script> <script src="/build/js/NotificationIndicator-905ffe2297.js"></script> <script src="/build/js/NotificationIcon-e8c973a511.js"></script> <script src="/build/js/Comments-c3614503e2.js"></script> <script src="/build/js/PinnedComments-e4d532f3d0.js"></script> </body> </html>