TV Shows API

If you want to add TV Shows information to your website or app then you've come to the right place!
We provide a fast and clean REST API that's easy to use, returns JSON. The root url is https://www.episodate.com/api/ and the available endpoints are documented below.

Endpoints

Most Popular TV Shows

A complete list of Most Popular TV Shows. TV Shows are returned in descending order and contain the basic information about them.

• URL: /api/most-popular?page=:page
• Example: https://www.episodate.com/api/most-popular?page=1

Search

Search through all the shows in our database by the show's name. A fuzzy algorithm is used, meaning that shows will be found even if your query contains small typos. Results are returned in order of name and contain the basic information about show.

• URL: /api/search?q=:search&page=:page
• Example: https://www.episodate.com/api/search?q=arrow&page=1

Show details

Retrieve all information for a given show.
To get TV Show details, use permalink or ID of the show. All air dates are retrieved in GMT timezone.

• URL: /api/show-details?q=:show
• Example: https://www.episodate.com/api/show-details?q=arrow
• Example: https://www.episodate.com/api/show-details?q=29560

Restrictions

• Use only as many API calls as you really need. If you have some special requirements, please contact us.
• If possible, save details of TV Show in your database and use CRON job to update them regularly.
  If you have small traffic on website/App you can use API calls directly on them.
• All output is cached by App for 60 minutes, so when information is updated on the site, please allow up to 1 hour for the changes to propagate to the API.

Licensing

Use of the EpisoDate.com API is licensed by CC BY-SA. This means the data can freely be used for any purpose, as long as EpisoDate.com is properly credited as source. You can do this by linking back to EpisoDate.com from within your application or website, for example using the URLs available in the API.

Contacting us

If you have any questions about this API, or have some special requirements, please contact us at [email protected] or using Contact form.