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

> 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.

## 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.

| Cecha                                                | TMDB                                          | OMDb                  | amodb                         |
| ---------------------------------------------------- | --------------------------------------------- | --------------------- | ----------------------------- |
| Cena, gdy aplikacja zarabia                          | $149 miesięcznie przy przychodach poniżej $1M | Warunki niekomercyjne | Od 3,11 USD miesięcznie       |
| Ścieżki i JSON z TMDB v3                             | Tak                                           | Nie                   | Tak                           |
| Parametry i pola OMDb                                | Nie                                           | Tak                   | Tak                           |
| Oceny IMDb, Rotten Tomatoes i Metacritic             | Nie, tylko ocena TMDB                         | Tak                   | Tak, a także Kinopoisk i TMDB |
| Mierniki nastroju, ścieżki dźwiękowe i repertuar kin | Nie                                           | Nie                   | Tak                           |
| Bez wymaganego logo i informacji na Twoich ekranach  | Nie, logo i informacja są wymagane            | Nie podano            | Tak                           |
| Jeden klucz do obu formatów                          | Nie                                           | Nie                   | Tak                           |

Źródła: [warunki API TMDB](https://www.themoviedb.org/api-terms-of-use), odpowiedzi przedstawicieli TMDB na temat [cen komercyjnych](https://www.themoviedb.org/talk/69cbf4f91b914f0e9542a772) i [tego, kiedy aplikacja jest komercyjna](https://www.themoviedb.org/talk/6ac5579ae24d7a00344571d5) oraz [strona prawna OMDb](https://www.omdbapi.com/legal.htm), sprawdzone w październiku 2026.

## 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.

```bash
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
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);
```

```python
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"
}
```

## 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":"..."}`.

```bash
curl "https://api.amodb.dev/omdb/?i=tt0137523&plot=short&apikey=$AMODB_KEY"
```

```js
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);
```

```python
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"
}
```

## 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.
- **Oceny w jednym wywołaniu**: IMDb, TMDB i trzy kolejne oceny z liczbą głosów, z jednego endpointu.
- **Limit, który widać**: Każda odpowiedź mówi, ile żądań zostało w tej minucie.
- **Jedno ID, 14 języków**: Ten sam film w każdym języku, który obsługuje amodb. Nieznane tagi wracają do angielskiego.
- **Każdy rozmiar obrazów TMDB**: Od miniatur w92 po pliki oryginalne na img.amodb.dev. Klucz nie jest potrzebny.
- **Wyszukiwanie po dowolnym zewnętrznym ID**: Podaj ID z IMDb lub inne zewnętrzne ID, a dostaniesz z powrotem rekord TMDB.
- **Seanse w kinach**: Seanse według kraju dla tytułów granych w kinach, gdy są znane.
- **Ścieżki dźwiękowe**: Utwory użyte w filmie lub serialu, pod tym samym bazowym URL.

## 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.

| Code | Language   | Native name | Example tag |
| ---- | ---------- | ----------- | ----------- |
| `en` | English    | English     | `en-US`     |
| `ru` | Russian    | Русский     | `ru-RU`     |
| `uk` | Ukrainian  | Українська  | `uk-UA`     |
| `be` | Belarusian | Беларуская  | `be-BY`     |
| `zh` | Chinese    | 中文          | `zh-CN`     |
| `pt` | Portuguese | Português   | `pt-BR`     |
| `bg` | Bulgarian  | Български   | `bg-BG`     |
| `he` | Hebrew     | עברית       | `he-IL`     |
| `cs` | Czech      | Čeština     | `cs-CZ`     |
| `ro` | Romanian   | Română      | `ro-RO`     |
| `fr` | French     | Français    | `fr-FR`     |
| `pl` | Polish     | Polski      | `pl-PL`     |
| `it` | Italian    | Italiano    | `it-IT`     |
| `es` | Spanish    | Español     | `es-ES`     |

## 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](https://amodb.dev/pl/terms/). 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.

## 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.

| Funkcja                             | Lite      | Pro       | Pro+       |
| ----------------------------------- | --------- | --------- | ---------- |
| Żądania na minutę                   | 20        | 40        | 120        |
| Żądania dziennie przy pełnym tempie | 28 800    | 57 600    | 172 800    |
| Cena za 1 miesiąc                   | 5,19 USD  | 6,19 USD  | 7,19 USD   |
| Cena za 3 miesiące                  | 14,01 USD | 16,71 USD | 19,41 USD  |
| Cena za 6 miesięcy                  | 24,91 USD | 29,71 USD | 34,51 USD  |
| Cena za 12 miesięcy                 | 43,60 USD | 52,00 USD | 60,40 USD  |
| Cena za 24 miesiące                 | 74,74 USD | 89,14 USD | 103,54 USD |

## Zbudowane pod ruch produkcyjny

Popularne listy są w cache przez 30 minut, szczegóły przez 6 godzin, a `configuration` przez 24 godziny.
Każda odpowiedź zawiera `X-RateLimit-Limit`, `X-RateLimit-Remaining` i `X-RateLimit-Reset`. Odpowiedź 429 dodaje `Retry-After`.
Błędy zwracają `success`, `status_code` i `status_message`, więc dotychczasowa obsługa błędów nadal działa.
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.

## Powiązane strony

- [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut.
- [Cennik](https://amodb.dev/pl/pricing/): Plany amodb płatne z góry różnią się tylko limitem żądań na minutę: 20, 40 lub 120. Każdy plan ma wszystkie dane TMDB v3 i OMDb. Bez odnowień i okresu próbnego.
- [amodb vs TMDB](https://amodb.dev/pl/amodb-vs-tmdb/): Bezpośrednie porównanie amodb i TMDB: zgodność endpointów, ścieżki, których amodb nie udostępnia, darmowe i płatne warunki, 14 języków, rozszerzenia i limity.
- [Alternatywa dla API TMDB](https://amodb.dev/pl/tmdb-api-alternative/): Szukasz alternatywy dla API TMDB? Sprawdź warunki, limity, języki i oceny, potem przejdź na płatne API z większością ścieżek odczytu i JSON z TMDB v3.

Zaktualizowano: 2026-10-19. Source: https://amodb.dev/pl/
