# Documentação do amodb

> Comece pelo início rápido para fazer sua primeira chamada em dois minutos. Depois leia como funcionam as chaves, os limites, os erros, os idiomas e as imagens. O amodb mantém os caminhos e o JSON do TMDB v3 e do OMDb, então a maioria das páginas explica o que é igual, o que o amodb acrescenta e onde ele difere.

## URLs base

| Uso                | URL base                                  | Parâmetro da chave                   |
| ------------------ | ----------------------------------------- | ------------------------------------ |
| Estilo TMDB v3     | `https://api.amodb.dev/3`                 | `api_key` ou `Authorization: Bearer` |
| Estilo OMDb        | `https://api.amodb.dev/omdb/`             | `apikey`                             |
| Imagens            | `https://img.amodb.dev/t/p/{size}/{file}` | nenhum                               |
| Catálogo de planos | `https://api.amodb.dev/plans`             | nenhum                               |

### Primeiros passos

- [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.
- [Autenticação](https://amodb.dev/pt/authentication/): Como enviar sua chave do amodb: api_key na consulta, um cabeçalho Authorization Bearer ou apikey nas chamadas OMDb. Formato, armazenamento, rotação e erros 401.

### Conceitos

- [Limites de requisições](https://amodb.dev/pt/rate-limits/): O amodb limita cada chave por requisições por minuto em uma janela de 60 segundos: 20, 40 ou 120 por plano. Leia os cabeçalhos e trate o 429 com Retry-After.
- [Erros](https://amodb.dev/pt/errors/): Todos os erros do amodb com status HTTP, status_code e mensagem do TMDB, mais o formato de erro do OMDb. O que cada um significa e o que seu cliente deve fazer.
- [Idiomas](https://amodb.dev/pt/languages/): O amodb serve títulos, sinopses e nomes em 14 idiomas. Passe uma tag no estilo TMDB como ru-RU ou pt-BR em language; qualquer outra tag volta para o inglês.
- [Imagens](https://amodb.dev/pt/images/): Pôsteres, backdrops e fotos de perfil em img.amodb.dev com caminhos e tamanhos do TMDB, de w92 a original. Sem chave, cache de 30 dias e um só padrão de URL.

### Referência da API

- [API de detalhes de filmes](https://amodb.dev/pt/movies/): API de detalhes de filmes com caminhos e JSON do TMDB v3. Busque um filme por id e junte créditos, avaliações e moods com append_to_response, em 14 idiomas.
- [API de séries de TV](https://amodb.dev/pt/tv-series/): API de séries de TV com os mesmos caminhos e JSON do TMDB v3. Busque uma série por id com temporadas, emissoras, próximo episódio e classificações.
- [API de temporadas e episódios de séries](https://amodb.dev/pt/tv-seasons-episodes/): API de temporadas e episódios com os mesmos caminhos e JSON do TMDB v3. Leia uma temporada com todos os episódios, ou um episódio com data, duração e still.
- [API de detalhes de pessoas](https://amodb.dev/pt/people/): API de detalhes de pessoas com os caminhos e o JSON do TMDB v3. Busque um ator ou membro da equipe por id, com biografia, filmografia e ids externos.
- [API de créditos](https://amodb.dev/pt/credits/): API de créditos com caminhos e JSON iguais aos do TMDB v3. Elenco e equipe técnica de filmes, séries, temporadas e episódios, com order, department e job.
- [API de busca](https://amodb.dev/pt/search/): API de busca com caminhos e JSON do TMDB v3. Encontre filmes, séries, pessoas, coleções, produtoras e palavras-chave por texto, com filtro de ano e paginação.
- [API Discover](https://amodb.dev/pt/discover/): API Discover com os mesmos filtros do TMDB v3. Liste filmes e séries por gênero, elenco, produtora, palavra-chave, ano, nota, duração e provedor, com ordenação.
- [Endpoints de em alta e de listas](https://amodb.dev/pt/trending-lists/): API de filmes em alta com caminhos do TMDB v3: rankings do dia e da semana, listas em cartaz, populares, mais bem avaliados e em breve. Cache de 30 minutos.
- [Gêneros e listas de consulta](https://amodb.dev/pt/genres/): API de gêneros com caminhos do TMDB v3: ids de gênero de filmes e TV com nomes traduzidos, mais listas de países, idiomas, funções, classificações e provedores.
- [API de imagens e host de imagens](https://amodb.dev/pt/images-api/): API de imagens de filmes com caminhos do TMDB v3: liste pôsteres, backdrops, logos e stills por título e carregue-os de img.amodb.dev em 10 tamanhos, sem chave.
- [API de vídeos e trailers](https://amodb.dev/pt/videos-trailers/): API de vídeos de filmes com caminhos do TMDB v3: liste trailers, teasers, clipes e featurettes de um filme ou série e filtre por tipo e idioma no seu código.
- [API de traduções](https://amodb.dev/pt/translations/): API de traduções de filmes com caminhos do TMDB v3: leia todos os títulos, sinopses e taglines de um filme, série ou episódio em todos os idiomas.
- [API de palavras-chave](https://amodb.dev/pt/keywords/): API de palavras-chave de filmes com caminhos TMDB v3: liste as tags de enredo de um filme ou série, consulte uma palavra-chave e use with_keywords no discover.
- [API de coleções](https://amodb.dev/pt/collections/): API de coleções de filmes com caminhos do TMDB v3: busque uma franquia por id com todas as partes, leia belongs_to_collection de um filme e pesquise por nome.
- [Produtoras e emissoras](https://amodb.dev/pt/companies-networks/): Consulte produtoras e emissoras de TV com caminhos do TMDB v3. Leia nome, país e logo por id e depois filtre o discover por id de produtora ou emissora.
- [Avaliações de filmes e séries](https://amodb.dev/pt/ratings/): API de avaliações de filmes com as notas do IMDb, Kinopoisk, Metacritic, Rotten Tomatoes e TMDB em uma só chamada, com null se a fonte for desconhecida.
- [Buscar por ID externo](https://amodb.dev/pt/find-by-external-id/): Busque um filme, série ou pessoa por id do IMDb, TVDB, Wikidata ou Kinopoisk com o endpoint find do TMDB e leia ids externos e dados do Wikidata de um título.
- [Endpoint compatível com OMDb](https://amodb.dev/pt/omdb-endpoint/): Endpoint compatível com OMDb API em api.amodb.dev/omdb/. Busque por i ou t, pesquise com s, leia o array Ratings e mantenha seu cliente trocando só a URL base.
- [Medidores de mood](https://amodb.dev/pt/moods/): API de moods de filmes com medidores de 0 a 10 por título. Leia os moods de um filme ou série, junte-os com append_to_response=moods e crie selos ou filtros.
- [Trilhas sonoras](https://amodb.dev/pt/soundtracks/): API de trilha sonora de filmes: retorna o álbum de um filme ou série com a lista de faixas. Chame o endpoint ou use append_to_response=soundtracks.
- [Horários de sessões de cinema](https://amodb.dev/pt/showtimes/): API de horários de sessões que retorna os locais de exibição e as sessões de um filme em um país, ou o resumo por país. Junte aos detalhes ou ao now_playing.

### Recursos

- [Histórico de alterações](https://amodb.dev/pt/changelog/): Lista datada das mudanças na API do amodb, no host de imagens img.amodb.dev, nos planos e no site. As novas vêm primeiro, com o que mudou e o que fazer.

- [Status](https://amodb.dev/pt/status/): Como saber se o amodb está no ar: o endpoint de saúde público, os erros que indicam um incidente e como relatar um problema com os detalhes necessários.

- [Referência da API](https://amodb.dev/pt/reference/): Todos os endpoints do amodb com caminho, parâmetros, exemplos de requisição em cinco linguagens e uma resposta JSON real. Compatível com TMDB v3 e OMDb.

- [Tutoriais](https://amodb.dev/pt/tutorials/): Tutoriais passo a passo da API do amodb: busca, detalhes, imagens, idiomas e chamadas OMDb em stacks comuns, cada um com código que você pode copiar e executar.

- [Comparar o amodb](https://amodb.dev/pt/compare/): Comparações lado a lado do amodb com outras APIs de metadados de filmes e séries: compatibilidade, idiomas, limites, imagens e preços, com números verificáveis.

- [Casos de uso](https://amodb.dev/pt/use-cases/): Como equipes usam o amodb para dados de filmes e séries: catálogos, servidores de mídia, recomendação, bots e pesquisa, com os endpoints e limites de cada caso.

## 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.
- [Autenticação](https://amodb.dev/pt/authentication/): Como enviar sua chave do amodb: api_key na consulta, um cabeçalho Authorization Bearer ou apikey nas chamadas OMDb. Formato, armazenamento, rotação e erros 401.
- [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.

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