search

UweTrottmann / thetvdb-java

Unofficial TheTVDB.com API wrapper in Java written using retrofit2.
Apache License 2.0
18 stars 9 forks source link

Support upcoming API v4 #35

Closed UweTrottmann closed 3 years ago

UweTrottmann commented 4 years ago

Thanks so much for your interest in testing our beta of TheTVDB’s forthcoming v4 API. This is a brand new API and will not be backwards compatible with our other older APIs.

The new API is meant to be more efficient, with more 1:1 relationships. We have been hard at work designing the new features available in this API for the last 9 months and are excited to finally unveil what it is capable of.

This is the API key you will temporarily use to access the v4 API:

7e8bc22c-ae9c-4abf-b246-07ed665c8e96

This key will expire at the end of the year, at which point you’ll have to use your own v4 project key. More information on this will be coming with the official launch of the API.

Our beta documentation is available here: https://app.swaggerhub.com/apis-docs/thetvdb/tvdb-api_v_4/4.0.0#/

For a brief overview, here are the new features of v4: Flexible Seasons: Supporting DVD and absolute orders as we’ve always done, but also supporting multiple official popular orders (for example, Money Heist being completely recut for Netflix) Expanded Company Support: Companies will be expanded from studio, production company, and network to also include other relevant info like distributor and special effects studio. Plus company relationships, rebrands, and the ability to store co-productions on series and movies. Tagging & Taxonomy: Our new flexible tagging system includes a hierarchy of data that is more useful than free-form tagging, and currently includes information like time era, series structure, social issues, character professions, and more. Tags can be recommended by users on the site so this offering will quickly expand. Awards: We’re now tracking popular awards for both series and movies, including both nominees and winners. International Content Ratings: Content ratings, previously displayed as parental guidelines, are now expanded from the US rating systems to all official international systems. And coming soon... Expanded Search Functionality: Unified search for movies, TV series, person, character, franchise, companies - all allowing fuzzy matching to improve results. Custom Lists & Official Franchises: Fully translatable and sorted, allowing access to official franchises like the MCU and Arrowverse.

Please feel free to explore the API, play around with some of the new features/endpoints, and send us your thoughts at support@thetvdb.com. Please also send over any bugs you might come across. Thanks again, and we’re looking forward to hearing any feedback you have to give — it’ll be much appreciated and valued by our team.

UweTrottmann commented 3 years ago

Won't do this myself. If anyone wants to take over maintaining this repo, let me know (vs. just forking).