Chave da API do TMDB: uma chave compatível em cerca de 1 minuto

Obtenha uma chave compatível com o TMDB em quatro passos

O amodb vende chaves para a própria API, que mantém os caminhos e o JSON do TMDB v3. Não é uma chave do TMDB e não funciona em api.themoviedb.org. O que você recebe é uma chave com o mesmo formato, 32 caracteres hexadecimais minúsculos, que o seu cliente TMDB aceita depois de uma única troca de URL base.

1. Abra preços e escolha um plano: 20, 40 ou 120 requisições por minuto. Todo plano retorna todos os dados.
2. Entre com seu e-mail. O amodb envia um código de 6 dígitos válido por 10 minutos. Não há senha.
3. Pague com cartão, Apple Pay ou Google Pay por 1 a 24 meses. Nada renova automaticamente.
4. Abra Conta, depois Chaves de API, e crie uma chave. Copie-a na hora, porque a chave completa é exibida uma só vez.

Os passos levam cerca de um minuto, e a chave funciona assim que o pagamento é confirmado.

Use a chave: troque a URL base

Mantenha seu código do TMDB e troque dois valores, a URL base e a chave. As duas formas de enviar a chave funcionam, api_key na consulta e um cabeçalho Authorization: Bearer.

# TMDB
curl "https://api.themoviedb.org/3/movie/550?api_key=$TMDB_KEY"

# amodb
curl "https://api.amodb.dev/3/movie/550?api_key=$AMODB_KEY"

A mesma chamada com um cabeçalho Bearer, em três linguagens:

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}` },
});
if (!res.ok) throw new Error(`amodb ${res.status}`);
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,
)
res.raise_for_status()
movie = res.json()
print(movie["title"], movie["release_date"])

A resposta tem o formato do TMDB v3:

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

Leia images.secure_base_url em /3/configuration para que os links dos pôsteres apontem para img.amodb.dev. As imagens não precisam de chave. Mais detalhes sobre o envio da chave estão em autenticação, e um passo a passo mais longo está no início rápido.

Uma chave gratuita do TMDB e uma chave do amodb lado a lado

A escolha certa depende do seu projeto e dos seus termos, não de uma lista de recursos. A coluna do TMDB apenas repete o que o TMDB publica de forma geral. Leia os termos e a documentação do próprio TMDB para ver as regras atuais.

Quando uma chave gratuita do TMDB basta

Fique com uma chave gratuita do TMDB para um projeto pessoal ou de estudo que se encaixe nos termos do TMDB. Se o seu uso for elegível, o TMDB não custa nada e o amodb não consegue igualar isso.

Use uma chave do amodb quando o projeto for comercial e você quiser um acordo pago, quando precisar de um limite fixo por minuto para se planejar, ou quando a página de um título deva receber avaliações de cinco fontes em uma única chamada. Confira antes as lacunas: métodos de escrita, feeds de alterações e alguns outros caminhos não são oferecidos. Eles estão listados em alternativa à API do TMDB e em amodb vs TMDB.

Uso comercial e limites

O uso comercial é permitido pelos termos de uso do amodb. Você pode exibir os dados em seus apps, sites, bots e ferramentas internas, e guardar respostas em cache para economizar requisições. Você não pode revender o acesso bruto à API, publicar dumps em massa, compartilhar chaves nem abrir contas extras para aumentar sua taxa. A lista completa está na política de uso aceitável.

O plano define a taxa. Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset, e um 429 acrescenta Retry-After. Os detalhes estão em limites de requisições.