API metadanych filmów i seriali

API filmów ze wszystkimi ocenami, zgodne z TMDB i OMDb

Zmień jeden URL, zachowaj kod dla TMDB lub OMDb i dostań oceny IMDb, Rotten Tomatoes, Metacritic i Kinopoisk w tej samej odpowiedzi.

GEThttps://api.amodb.dev/3/movie/550?language=en-US

200 OKapplication/json1,7 kBOdpowiedź na żywo

{  "id": 550,  "imdb_id": "tt0137523",  "title": "Fight Club",  "tagline": "Mischief. Mayhem. Soap.",  "release_date": "1999-10-15",  "runtime": 139,  "status": "Released",  "genres": [{ "id": 18, "name": "Drama" }, { "id": 53, "name": "Thriller" }],  "origin_country": ["US", "DE"],  "original_language": "en",  "budget": 63000000,  "revenue": 101209702,  "vote_average": 8.437,  "vote_count": 33042,  "popularity": 39.0054,  "poster_path": "/jSziioSwPVrOy9Yow3XhWIBDjq1.jpg",  "backdrop_path": "/b9HyPoxwxjxkWEUL5ErZdhApQe2.jpg"}

amodb to płatne API filmów i seriali, które zachowuje ścieżki i JSON z TMDB v3 oraz OMDb, więc Twój kod działa po zmianie bazowego URL. Jeden klucz dodaje oceny IMDb, Rotten Tomatoes, Metacritic i Kinopoisk, mierniki nastroju i ścieżki dźwiękowe, a użycie komercyjne jest w cenie każdego planu opłacanego z góry.

01 · /compare?tmdb&omdb

Po co płacić za API filmów, skoro TMDB jest darmowe?

TMDB jest darmowe, dopóki Twoja aplikacja nie zarobi pierwszego dolara. Potem TMDB wymaga planu komercyjnego, $149 miesięcznie dla firm z przychodami poniżej $1M. TMDB nie ma też ocen IMDb, Rotten Tomatoes ani Metacritic, a OMDb, zwykle drugie API, jest licencjonowane do użytku niekomercyjnego. amodb to oba formaty w jednym kluczu, z użyciem komercyjnym w cenie od 3,11 USD miesięcznie.

CechaTMDBOMDbamodb
Cena, gdy aplikacja zarabia$149 miesięcznie przy przychodach poniżej $1MWarunki niekomercyjneOd 3,11 USD miesięcznie
Ścieżki i JSON z TMDB v3TakNieTak
Parametry i pola OMDbNieTakTak
Oceny IMDb, Rotten Tomatoes i MetacriticNie, tylko ocena TMDBTakTak, a także Kinopoisk i TMDB
Mierniki nastroju, ścieżki dźwiękowe i repertuar kinNieNieTak
Bez wymaganego logo i informacji na Twoich ekranachNie, logo i informacja są wymaganeNie podanoTak
Jeden klucz do obu formatówNieNieTak

Źródła: warunki API TMDB, odpowiedzi przedstawicieli TMDB na temat cen komercyjnych i tego, kiedy aplikacja jest komercyjna oraz strona prawna OMDb, sprawdzone w październiku 2026.

02 · /3/movie/550

Zmień bazowy URL, zachowaj swój kod

amodb odpowiada pod tymi samymi ścieżkami co TMDB v3. Żądanie o film 550 zwraca te same pola JSON, które Twój klient już przetwarza: id, title, genres, release_date, poster_path i pozostałe.

Podaj klucz jako api_key w zapytaniu lub w nagłówku Authorization: Bearer. Obie metody działają w każdym endpoincie.

  1. Zdobądź klucz

    Wybierz plan i skopiuj klucz ze swojego konta.

    Authorization: Bearer $AMODB_KEY
  2. Zmień bazowy URL

    Skieruj klienta TMDB lub OMDb na api.amodb.dev.

    api.themoviedb.orgapi.amodb.dev
  3. Wdrażaj

    Wraca ten sam JSON, więc parser działa bez zmian.

    200 OKapplication/json
bashjspy
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const movie = await res.json();
console.log(movie.title, movie.release_date);
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
movie = res.json()
print(movie["title"], movie["release_date"])
JSON
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}

03 · /omdb/?i=tt0137523

Jeden klucz do wywołań w stylu OMDb

Endpoint zgodny z OMDb działa pod adresem https://api.amodb.dev/omdb/. Przyjmuje i, t, s, type, y, plot oraz page i zwraca Title, Year, imdbRating, Ratings i pozostałe pola OMDb.

Pole Poster wskazuje na img.amodb.dev, więc plakaty ładują się z tej samej usługi. Błędy zachowują format OMDb: {"Response":"False","Error":"..."}.

bashjspy
curl "https://api.amodb.dev/omdb/?i=tt0137523&plot=short&apikey=$AMODB_KEY"
const url = new URL("https://api.amodb.dev/omdb/");
url.searchParams.set("t", "Fight Club");
url.searchParams.set("y", "1999");
url.searchParams.set("apikey", process.env.AMODB_KEY);

const film = await (await fetch(url)).json();
console.log(film.Title, film.imdbRating);
import os
import requests

film = requests.get(
    "https://api.amodb.dev/omdb/",
    params={"i": "tt0137523", "apikey": os.environ["AMODB_KEY"]},
    timeout=10,
).json()
print(film["Title"], film["imdbRating"])
JSON
{
  "Title": "Fight Club",
  "Year": "1999",
  "Runtime": "139 min",
  "Director": "David Fincher",
  "imdbRating": "8.8",
  "imdbID": "tt0137523",
  "Poster": "https://img.amodb.dev/t/p/w300/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
  "Response": "True"
}

04 · append_to_response

Dane, których TMDB v3 nie zwraca

Każdy klucz może wywoływać rozszerzenia amodb pod tym samym bazowym URL. Dodaj je przez append_to_response albo wywołaj osobno.

  • Mierniki nastroju

    Strach, humor, smutek, przemoc i inne wskaźniki w skali od 0 do 10, jednym dodatkowym wywołaniem.

    GET /3/tv/1396/moods
  • Oceny w jednym wywołaniu

    IMDb, TMDB i trzy kolejne oceny z liczbą głosów, z jednego endpointu.

    GET /3/movie/550/ratings
  • Limit, który widać

    Każda odpowiedź mówi, ile żądań zostało w tej minucie.

    X-RateLimit-Limit: 40
  • Każdy rozmiar obrazów TMDB

    Od miniatur w92 po pliki oryginalne na img.amodb.dev. Klucz nie jest potrzebny.

    img.amodb.dev/t/p/w500/…
  • Wyszukiwanie po dowolnym zewnętrznym ID

    Podaj ID z IMDb lub inne zewnętrzne ID, a dostaniesz z powrotem rekord TMDB.

    GET /3/find/tt0137523
  • Seanse w kinach

    Seanse według kraju dla tytułów granych w kinach, gdy są znane.

    GET /3/movie/550/showtimes?country=US
  • Ścieżki dźwiękowe

    Utwory użyte w filmie lub serialu, pod tym samym bazowym URL.

    GET /3/movie/157336/soundtracks

05 · ?language=uk-UA

Tytuły i opisy w 14 językach

Podaj w language tag w stylu TMDB, na przykład ru-RU lub pt-BR. amodb obsługuje 14 języków bazowych, a dla każdego innego tagu wraca do angielskiego, więc żądanie nigdy nie kończy się błędem z powodu języka.

Język

Spirited Away

Унесённые призраками

Віднесені привидами

Скрадзеныя прывідамі

千与千寻

A Viagem de Chihiro

Отнесени от духове

המסע המופלא

Cesta do fantazie

Călătoria lui Chihiro

Le Voyage de Chihiro

Spirited Away: W krainie Bogów

La città incantata

El viaje de Chihiro

  • en English Spirited Away
  • ru Русский Унесённые призраками
  • uk Українська Віднесені привидами
  • be Беларуская Скрадзеныя прывідамі
  • zh 中文 千与千寻
  • pt Português A Viagem de Chihiro
  • bg Български Отнесени от духове
  • he עברית המסע המופלא
  • cs Čeština Cesta do fantazie
  • ro Română Călătoria lui Chihiro
  • fr Français Le Voyage de Chihiro
  • pl Polski Spirited Away: W krainie Bogów
  • it Italiano La città incantata
  • es Español El viaje de Chihiro

Stworzone dla projektów osobistych i komercyjnych

Weekendowy projekt i płatny produkt wywołują to samo API, dostają te same dane i podlegają temu samemu regulaminowi. Oto, co zespoły na nim budują.

  • Aplikacje streamingowe i watchlisty Plakaty, zwiastuny, sezony i odcinki oraz pięć ocen do sortowania i filtrowania.
  • Boty na Telegram i Discord Wyszukiwanie w stylu OMDb po tytule lub ID IMDb zwraca gotową odpowiedź jednym wywołaniem.
  • Serwery multimediów i wtyczki Skrypty pobierające metadane, które już obsługują TMDB v3, zachowują swojego klienta i zyskują oceny IMDb i Rotten Tomatoes.
  • Serwisy i blogi filmowe Tytuły i opisy w 14 językach, więc każdy rynek dostaje własną stronę.
  • Silniki rekomendacji Mierniki nastroju oceniają strach, humor, przemoc i więcej w skali od 0 do 10, czyli sygnały, które same gatunki pomijają.
  • Agenci AI i chatboty Odpowiadaj na pytanie „co obejrzeć dziś wieczorem” prawdziwymi ocenami, nastrojami, obsadą i seansami.

06 · /plans

Plany różnią się liczbą żądań na minutę

Każdy plan daje dostęp do tych samych danych: endpointów TMDB i OMDb, wszystkich 14 języków, obrazów i rozszerzeń. Pro+ dodatkowo obejmuje /3/all: wszystko o filmie, serialu lub osobie w jednym żądaniu. Płacisz raz za okres trwający 1, 3, 6, 12 lub 24 mies., a dłuższy okres kosztuje mniej za miesiąc. Nie ma darmowego planu ani automatycznego odnawiania.

Cennik

07 · X-RateLimit-Remaining

Zbudowane pod ruch produkcyjny

  • Wspólny cache na edge

    Popularne listy są w cache przez 30 minut, szczegóły przez 6 godzin, a configuration przez 24 godziny.

  • Czytelne limity żądań

    Każda odpowiedź zawiera X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Odpowiedź 429 dodaje Retry-After.

  • Błędy w stylu TMDB

    Błędy zwracają success, status_code i status_message, więc dotychczasowa obsługa błędów nadal działa.

  • Obrazy bez klucza

    Plakaty i tła ładują się z img.amodb.dev/t/p/{size}/{file} we wszystkich rozmiarach TMDB i są w cache przez 30 dni.

Pytania i odpowiedzi

Czy API TMDB jest darmowe do użytku komercyjnego?

Nie. Klucz TMDB jest darmowy, dopóki projekt nic nie zarabia. Według przedstawicieli TMDB każdy przychód z reklam, zakupów w aplikacji, darowizn lub subskrypcji czyni aplikację komercyjną, a plan komercyjny kosztuje $149 miesięcznie dla firm z przychodami poniżej $1M. amodb zawiera użycie komercyjne w każdym planie.

Ile kosztuje API TMDB?

Do użytku niekomercyjnego jest darmowe. Za aplikację komercyjną przedstawiciele TMDB podają $149 miesięcznie przy rocznych przychodach poniżej $1M i cenę indywidualną powyżej tego progu. Plany amodb kosztują kilka dolarów miesięcznie i różnią się głównie liczbą żądań na minutę.

Po co płacić za amodb, skoro API TMDB jest darmowe?

Bo płatna aplikacja nie jest na TMDB darmowa. amodb kosztuje ułamek komercyjnego planu TMDB za $149, nie wymaga logo na Twoich ekranach i zwraca oceny IMDb, Rotten Tomatoes, Metacritic i Kinopoisk w tej samej odpowiedzi. Jeden klucz obsługuje formaty TMDB v3 i OMDb, więc utrzymujesz jedno API zamiast dwóch.

Czy OMDb jest darmowe do użytku komercyjnego?

Strona prawna OMDb opisuje usługę jako przeznaczoną do użytku osobistego, niekomercyjnego, a jej treści licencjonuje na CC BY-NC 4.0. amodb odpowiada na te same parametry OMDb z tymi samymi nazwami pól, a użycie komercyjne jest w cenie.

Czy muszę zmieniać kod mojego klienta TMDB?

Nie. Skieruj bazowy URL na https://api.amodb.dev/3 i podawaj klucz amodb jako api_key lub jako token Bearer. Ścieżki, parametry zapytania i pola JSON pozostają takie same jak w TMDB v3.

Czy ten sam klucz działa w wywołaniach w stylu OMDb?

Tak. Wyślij go jako apikey na https://api.amodb.dev/omdb/. Parametry: i, t, s, type, y, plot oraz page działają jak w OMDb, a odpowiedź używa nazw pól OMDb.

Czy jest darmowy plan lub okres próbny?

Nie. amodb działa wyłącznie z płatnością z góry. Wybierasz plan i okres, płacisz raz kartą, przez Apple Pay, Google Pay, kryptowalutami lub przez Patreon, a klucz działa do końca okresu. Nie ma automatycznego odnawiania.

Czym różnią się plany?

Tempem żądań: 20, 40 lub 120 żądań na minutę. Każdy plan daje dostęp do tych samych danych, wszystkich 14 języków, obrazów, ocen i pozostałych rozszerzeń amodb. Pro+ dodatkowo obejmuje /3/all: wszystko o filmie, serialu lub osobie w jednym żądaniu.

Jakie języki są obsługiwane?

Angielski, rosyjski, ukraiński, białoruski, chiński, portugalski, bułgarski, hebrajski, czeski, rumuński, francuski, polski, włoski i hiszpański. Podaj tag w stylu TMDB, na przykład ru-RU; każdy inny język wraca do angielskiego.

Zacznij od jednego klucza

Każdy plan daje dostęp do tych samych danych, wszystkich 14 języków i obrazów. Plany różnią się liczbą żądań na minutę, a Pro+ dodatkowo obejmuje /3/all: wszystko o filmie, serialu lub osobie w jednym żądaniu.

$ curl https://api.amodb.dev/3/movie/550 -H "Authorization: Bearer $AMODB_KEY"