# A API de filmes com todas as notas, compatível com TMDB e OMDb

> O amodb é uma API paga de filmes e séries que mantém os caminhos e o JSON do TMDB v3 e do OMDb, então seu código funciona depois de trocar a URL base. Uma chave traz notas do IMDb, Rotten Tomatoes, Metacritic e Kinopoisk, medidores de mood e trilhas sonoras, e todo plano pré-pago inclui uso comercial.

## Por que pagar por uma API de filmes se o TMDB é gratuito?

O TMDB é gratuito até o seu app faturar o primeiro dólar. Depois disso, o TMDB pede o plano comercial, $149 por mês para empresas com receita abaixo de $1M. O TMDB também não tem notas do IMDb, Rotten Tomatoes ou Metacritic, e o OMDb, a segunda API de costume, é licenciado para uso não comercial. O amodb reúne os dois formatos em uma chave, com uso comercial incluído a partir de US$ 3,11 por mês.

| Recurso                                                  | TMDB                                   | OMDb                  | amodb                        |
| -------------------------------------------------------- | -------------------------------------- | --------------------- | ---------------------------- |
| Preço quando seu app gera receita                        | $149 por mês com receita abaixo de $1M | Termos não comerciais | A partir de US$ 3,11 por mês |
| Caminhos e JSON do TMDB v3                               | Sim                                    | Não                   | Sim                          |
| Parâmetros e campos do OMDb                              | Não                                    | Sim                   | Sim                          |
| Notas do IMDb, Rotten Tomatoes e Metacritic              | Não, só a nota do TMDB                 | Sim                   | Sim, mais Kinopoisk e TMDB   |
| Medidores de mood, trilhas sonoras e horários de sessões | Não                                    | Não                   | Sim                          |
| Dispensa logo e aviso nas suas telas                     | Não, exige logo e aviso                | Não informado         | Sim                          |
| Uma chave para os dois formatos                          | Não                                    | Não                   | Sim                          |

Fontes: os [termos da API do TMDB](https://www.themoviedb.org/api-terms-of-use), as respostas da equipe do TMDB sobre [preço comercial](https://www.themoviedb.org/talk/69cbf4f91b914f0e9542a772) e sobre [quando um app conta como comercial](https://www.themoviedb.org/talk/6ac5579ae24d7a00344571d5), e a [página legal do OMDb](https://www.omdbapi.com/legal.htm), consultadas em outubro de 2026.

## Troque a URL base e mantenha seu código

O amodb responde nos mesmos caminhos do TMDB v3. Uma requisição do filme 550 retorna os mesmos campos JSON que seu cliente já processa: `id`, `title`, `genres`, `release_date`, `poster_path` e os demais.

Envie sua chave como `api_key` na consulta ou no cabeçalho `Authorization: Bearer`. As duas formas funcionam em todos os endpoints.

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

## Uma chave para chamadas no estilo OMDb

O endpoint compatível com OMDb fica em `https://api.amodb.dev/omdb/`. Ele aceita `i`, `t`, `s`, `type`, `y`, `plot` e `page`, e retorna `Title`, `Year`, `imdbRating`, `Ratings` e os demais campos do OMDb.

O campo `Poster` aponta para `img.amodb.dev`, então os pôsteres carregam do mesmo serviço. Os erros mantêm o formato do 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"
}
```

## Dados que o TMDB v3 não retorna

Toda chave pode chamar as extensões do amodb na mesma URL base. Adicione-as com `append_to_response` ou chame-as separadamente.

- **Medidores de mood**: Medo, humor, tristeza, violência e mais, cada um numa escala de 0 a 10, com uma chamada extra.
- **Avaliações em uma chamada**: IMDb, TMDB e mais três notas com contagem de votos, em um só endpoint.
- **Limite de requisições visível**: Cada resposta informa quantas requisições restam neste minuto.
- **Um id, 14 idiomas**: O mesmo filme em todos os idiomas que o amodb serve. Tags desconhecidas voltam para o inglês.
- **Todos os tamanhos de imagem do TMDB**: De miniaturas w92 a arquivos originais em img.amodb.dev. Sem chave.
- **Busca por qualquer ID externo**: Envie um id do IMDb ou outro id externo e receba o registro do TMDB.
- **Horários de sessões de cinema**: Horários por país para títulos em cartaz, quando conhecidos.
- **Trilhas sonoras**: As músicas usadas em um filme ou série, na mesma URL base.

## Títulos e sinopses em 14 idiomas

Passe em `language` uma tag no estilo TMDB, como `ru-RU` ou `pt-BR`. O amodb serve 14 idiomas base e volta para o inglês em qualquer outra tag, então uma requisição nunca falha por causa do idioma.

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

## Feito para projetos pessoais e comerciais

Um projeto de fim de semana e um produto pago chamam a mesma API, recebem os mesmos dados e seguem os mesmos [termos de uso](https://amodb.dev/pt/terms/). Isto é o que as equipes constroem com ela.

- **Apps de streaming e de lista de filmes:** pôsteres, trailers, temporadas e episódios, mais cinco notas para ordenar e filtrar.
- **Bots de Telegram e Discord:** uma busca no estilo OMDb por título ou id do IMDb devolve uma resposta pronta em uma só chamada.
- **Servidores de mídia e plugins:** scrapers de metadados que já falam TMDB v3 mantêm o cliente e ganham as notas do IMDb e do Rotten Tomatoes.
- **Sites e blogs de cinema:** títulos e sinopses em 14 idiomas, para que cada mercado tenha a sua própria página.
- **Motores de recomendação:** os medidores de mood avaliam medo, humor, violência e mais, de 0 a 10, sinais que só os gêneros não captam.
- **Agentes de IA e chatbots:** responda a "o que assistir hoje à noite" com notas reais, moods, elenco e horários de sessões.

## Os planos diferem em requisições por minuto

Todo plano dá acesso aos mesmos dados: os endpoints TMDB e OMDb, os 14 idiomas, as imagens e as extensões. O Pro+ também inclui `/3/all`: tudo sobre um filme, série ou pessoa em uma única requisição. Você paga uma vez por 1, 3, 6, 12 ou 24 meses, e um período mais longo custa menos por mês. Não há plano gratuito nem renovação automática.

| Recurso                            | Lite      | Pro       | Pro+       |
| ---------------------------------- | --------- | --------- | ---------- |
| Requisições por minuto             | 20        | 40        | 120        |
| Requisições por dia na taxa máxima | 28.800    | 57.600    | 172.800    |
| Preço para 1 mês                   | US$ 5,19  | US$ 6,19  | US$ 7,19   |
| Preço para 3 meses                 | US$ 14,01 | US$ 16,71 | US$ 19,41  |
| Preço para 6 meses                 | US$ 24,91 | US$ 29,71 | US$ 34,51  |
| Preço para 12 meses                | US$ 43,60 | US$ 52,00 | US$ 60,40  |
| Preço para 24 meses                | US$ 74,74 | US$ 89,14 | US$ 103,54 |

## Feito para tráfego de produção

Listas populares ficam em cache por 30 minutos, detalhes por 6 horas e `configuration` por 24 horas.
Toda resposta traz `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`. Um 429 acrescenta `Retry-After`.
Os erros retornam `success`, `status_code` e `status_message`, então o tratamento de erros que você já tem continua funcionando.
Pôsteres e backdrops carregam de `img.amodb.dev/t/p/{size}/{file}` em todos os tamanhos do TMDB, com cache de 30 dias.

## Perguntas e respostas

### A API do TMDB é gratuita para uso comercial?

Não. A chave do TMDB é gratuita enquanto seu projeto não gera receita. A equipe do TMDB diz que qualquer receita com anúncios, compras no app, doações ou assinaturas torna um app comercial, e o plano comercial custa $149 por mês para empresas com receita abaixo de $1M. O amodb inclui uso comercial em todos os planos.

### Quanto custa a API do TMDB?

É gratuita para uso não comercial. Para um app comercial, a equipe do TMDB cita $149 por mês quando a receita anual é inferior a $1M, e um preço personalizado acima disso. Os planos do amodb custam alguns dólares por mês e diferem principalmente em requisições por minuto.

### Por que pagar pelo amodb se a API do TMDB é gratuita?

Porque um app que gera receita não é gratuito no TMDB. O amodb custa uma fração do plano comercial de $149 do TMDB, não exige logo nas suas telas e retorna notas do IMDb, Rotten Tomatoes, Metacritic e Kinopoisk na mesma resposta. Uma chave atende os formatos TMDB v3 e OMDb, então você opera uma API em vez de duas.

### O OMDb é gratuito para uso comercial?

A página legal do OMDb descreve o serviço para uso pessoal e não comercial e licencia seu conteúdo sob CC BY-NC 4.0. O amodb responde aos mesmos parâmetros do OMDb com os mesmos nomes de campo, e o uso comercial está incluído.

### Preciso mudar o código do meu cliente TMDB?

Não. Aponte a URL base para https://api.amodb.dev/3 e envie sua chave do amodb como api_key ou como token Bearer. Caminhos, parâmetros de consulta e campos JSON continuam iguais aos do TMDB v3.

### A mesma chave funciona em chamadas no estilo OMDb?

Sim. Envie-a como apikey para https://api.amodb.dev/omdb/. Os parâmetros i, t, s, type, y, plot e page funcionam como no OMDb, e a resposta usa os nomes de campo do OMDb.

### Existe plano gratuito ou período de teste?

Não. O amodb é somente pré-pago. Você escolhe um plano e um período, paga uma vez por cartão, Apple Pay, Google Pay, cripto ou Patreon, e a chave funciona até o fim do período. Não há renovação automática.

### Qual é a diferença entre os planos?

A taxa de requisições: 20, 40 ou 120 por minuto. Todo plano dá acesso aos mesmos dados, aos 14 idiomas, às imagens, às notas e às demais extensões do amodb. O Pro+ também inclui /3/all: tudo sobre um filme, série ou pessoa em uma única requisição.

### Quais idiomas são atendidos?

Inglês, russo, ucraniano, bielorrusso, chinês, português, búlgaro, hebraico, tcheco, romeno, francês, polonês, italiano e espanhol. Passe uma tag no estilo TMDB, como ru-RU; qualquer outro idioma volta para o inglês.

## Páginas relacionadas

- [Início rápido](https://amodb.dev/pt/quickstart/): Faça sua primeira chamada ao amodb: obtenha uma chave, peça um filme em curl, JavaScript, Python, PHP ou Go e carregue o pôster. Menos de 2 minutos.
- [Preços](https://amodb.dev/pt/pricing/): Os planos do amodb diferem só em requisições por minuto: 20, 40 ou 120. Todo plano inclui todos os dados do TMDB v3 e OMDb. Pré-pago, sem renovação nem teste.
- [amodb vs TMDB](https://amodb.dev/pt/amodb-vs-tmdb/): Comparação direta entre amodb e TMDB: paridade de endpoints, caminhos que o amodb não oferece, termos gratuitos e pagos, 14 idiomas, extensões e limites.
- [Alternativa à API do TMDB](https://amodb.dev/pt/tmdb-api-alternative/): Precisa de uma alternativa à API do TMDB? Veja termos, limites, idiomas e avaliações, e migre para uma API paga com a maioria dos caminhos de leitura da v3.

Atualizado: 2026-10-19. Source: https://amodb.dev/pt/