Obter chave de API

API de metadados de filmes e séries

Dados de filmes e séries, compatíveis com TMDB e OMDb

Mesmos caminhos e JSON do TMDB v3 e do OMDb. Troque a URL base e mantenha seu código.

Obter chave de API Ler o início rápido
BASE_URL
  • https://api.themoviedb.org/3
  • https://api.amodb.dev/3
  • https://www.omdbapi.com/
  • https://api.amodb.dev/omdb/

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

200 OKapplication/json1,7 kBResposta ao vivo

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

O amodb é uma API paga de metadados de filmes e séries. Ele mantém caminhos, parâmetros e JSON do TMDB v3 e do OMDb, então um cliente existente funciona após trocar a URL base. Uma chave cobre os dois estilos, 14 idiomas e pôsteres em img.amodb.dev. Todos os planos incluem todos os dados e diferem apenas em requisições por minuto.

01 · /3/movie/550

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.

  1. Pegue uma chave

    Escolha um plano e copie a chave na sua conta.

    Authorization: Bearer $AMODB_KEY

  2. Troque a URL base

    Aponte seu cliente TMDB ou OMDb para api.amodb.dev.

    api.themoviedb.orgapi.amodb.dev

  3. Publique

    O mesmo JSON volta, e seu parser continua funcionando.

    200 OKapplication/json

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

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

02 · /omdb/?i=tt0137523

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

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

03 · append_to_response

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.

    GET /3/tv/1396/moods

  • Avaliações em uma chamada

    IMDb, TMDB e mais três notas com contagem de votos, em um só endpoint.

    GET /3/movie/550/ratings

  • Limite de requisições visível

    Cada resposta informa quantas requisições restam neste minuto.

  • Todos os tamanhos de imagem do TMDB

    De miniaturas w92 a arquivos originais em img.amodb.dev. Sem chave.

    img.amodb.dev/t/p/w500/…

  • Busca por qualquer ID externo

    Envie um id do IMDb ou outro id externo e receba o registro do TMDB.

    GET /3/find/tt0137523

  • Horários de sessões de cinema

    Horários por país para títulos em cartaz, quando conhecidos.

    GET /3/movie/550/showtimes?country=US

  • Trilhas sonoras

    As músicas usadas em um filme ou série, na mesma URL base.

    GET /3/movie/157336/soundtracks

04 · ?language=uk-UA

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.

Idioma

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

05 · /plans

Os planos diferem apenas em requisições por minuto

Todo plano inclui todos os endpoints, os 14 idiomas, as imagens e as extensões. 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.

  • Lite

    20 requisições por minuto

    a partir de US$ 3,11 por mês

    Obter Lite

  • Pro

    40 requisições por minuto

    a partir de US$ 3,71 por mês

    Obter Pro

  • Pro+

    120 requisições por minuto

    a partir de US$ 4,31 por mês

    Obter Pro+
Preços

06 · X-RateLimit-Remaining

Feito para tráfego de produção

  • Cache de borda compartilhado

    Listas populares ficam em cache por 30 minutos, detalhes por 6 horas e configuration por 24 horas.

  • Limites de requisições claros

    Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Um 429 acrescenta Retry-After.

  • Erros no estilo TMDB

    Os erros retornam success, status_code e status_message, então o tratamento de erros que você já tem continua funcionando.

  • Imagens sem chave

    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

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 e a chave funciona até o fim do período. Não há renovação automática.

Qual é a diferença entre os planos?

Apenas a taxa de requisições: 20, 40 ou 120 por minuto. Todo plano inclui todos os endpoints, os 14 idiomas, as imagens e as extensões do amodb.

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.

Comece com uma chave

Todo plano inclui todos os endpoints, os 14 idiomas e as imagens. Os planos diferem apenas em requisições por minuto.

Obter chave de API Ler o início rápido
$ curl https://api.amodb.dev/3/movie/550 -H "Authorization: Bearer $AMODB_KEY"