Use cases

API filmów do wyszukiwania, szczegółów i ocen

amodb to płatne API filmów pod adresem https://api.amodb.dev/3 z tymi samymi ścieżkami i JSON co TMDB v3. Wyszukaj tytuł przez /search/movie, potem pobierz film z append_to_response, by dostać obsadę, zwiastuny i oceny w jednym żądaniu. Odpowiedzi są w 14 językach, od 20 żądań na minutę.

API seriali: seriale, sezony i odcinki

API seriali zwraca serial pod GET /3/tv/{series_id} ze statusem, sieciami telewizyjnymi, listą sezonów i next_episode_to_air. Endpointy sezonów i odcinków dodają daty emisji, czas trwania i kadry. JSON odpowiada TMDB v3, w 14 językach, w przedpłaconych planach z 20, 40 lub 120 żądaniami na minutę.

API anime z filtrami discover

amodb nie ma osobnego endpointu dla anime. Anime wypiszesz przez /3/discover/tv lub /3/discover/movie z gatunkiem 16 i with_original_language=ja, a potem zawęzisz listę, używając ID słowa kluczowego anime z /3/search/keyword. Japoński nie jest obsługiwanym językiem interfejsu, ale original_name zachowuje oryginalny japoński tytuł.

API bazy filmów do twojego własnego katalogu

Używaj amodb jako źródła własnej bazy filmów. Filmy, osoby, firmy, kolekcje, słowa kluczowe i gatunki mają wspólne numeryczne ID, więc wiersze łączą się czysto. Zasil bazę paginacją discover w oknach dat premier, odświeżaj wiersze według wieku i dopasuj własne ID przez wyszukiwanie po zewnętrznym ID. JSON TMDB v3, od 20 do 120 żądań na minutę.

API plakatów filmowych i CDN obrazów

Plakaty ładują się z https://img.amodb.dev/t/p/{size}/{file} bez klucza API. Część file to poster_path z dowolnej odpowiedzi z filmem, wyszukiwaniem lub listą. Nazwy rozmiarów biegną od w92 do original, a include_image_language wybiera plakaty według języka. Klucz potrzebny jest tylko do wywołań JSON, które zwracają nazwy plików.

API zwiastunów filmowych

API zwiastunów filmowych to GET /3/movie/{movie_id}/videos na api.amodb.dev. Każde wideo niesie typ, flagę official, język i datę publikacji, więc oficjalny zwiastun wybierzesz jednym przebiegiem. Seriale zwracają ten sam kształt, a listę sortujesz własnym kodem. Ścieżki i JSON odpowiadają TMDB v3, więc istniejący klienci działają po zmianie bazowego URL.

API aktorów

API aktorów to rodzina endpointów osób z TMDB v3 pod adresem api.amodb.dev/3. Osobę pobierzesz przez GET /3/person/{person_id}, dodając combined_credits dostaniesz pełną filmografię, a dodając images zdjęcia profilowe. Lista popularnych osób, wyszukiwanie po nazwisku i wyszukiwanie po ID z IMDb używają tego samego klucza i kształtu JSON.

API wielojęzycznych metadanych filmów

To API wielojęzycznych metadanych filmów zwraca tytuły, opisy, slogany, nazwy gatunków i biografie w 14 językach: angielski, rosyjski, ukraiński, białoruski, chiński, portugalski, bułgarski, hebrajski, czeski, rumuński, francuski, polski, włoski i hiszpański. Wystarczy przekazać jeden tag TMDB, na przykład ru-RU, w parametrze language.

API seansów kinowych

API seansów kinowych to GET /3/movie/{movie_id}/showtimes?country=US. Zwraca kina z adresem i strefą czasową oraz każdy seans z godziną rozpoczęcia, formatami i linkiem do rezerwacji, jeśli są znane. Bez country dostaniesz tylko liczby według krajów. Pokrycie zależy od tytułu, a pusta tablica results oznacza, że nic nie wiadomo.

API przewodnika po odcinkach

API przewodnika po odcinkach wypisuje wszystkie odcinki serialu przez GET /3/tv/{tv_id}/season/{season_number}. Każdy odcinek ma nazwę, opis, datę emisji, czas trwania i kadr. Lista episode_groups nazywa alternatywne układy, na przykład DVD lub absolutny. Ścieżki i JSON odpowiadają TMDB v3, więc istniejący klienci potrzebują tylko nowego bazowego URL.