# API de anime com filtros do discover > O amodb não tem um endpoint separado para anime. Liste animes com /3/discover/tv ou /3/discover/movie usando o gênero 16 e with_original_language=ja, e refine com o ID da palavra-chave anime de /3/search/keyword. O japonês não é um idioma de interface atendido, mas original_name guarda o título em japonês. ## Encontre animes com o gênero 16 e idioma original ja O amodb não tem um endpoint separado para anime. Anime é um filtro em `GET /3/discover/tv` e `GET /3/discover/movie`: `with_genres=16` (Animação) mais `with_original_language=ja`. Adicione o ID da palavra-chave `anime`, que você consulta com `GET /3/search/keyword`, para manter apenas os títulos marcados como anime. Um limite a declarar: o japonês não é um dos 14 idiomas de interface que o amodb atende. Títulos e sinopses voltam no idioma que você pede, ou em inglês. O título em japonês fica em `original_name` nas séries e em `original_title` nos filmes. O que você recebe: - Séries de anime e filmes de anime com os mesmos filtros do discover. - Títulos originais em japonês ao lado dos localizados. - Listas de temporadas e episódios de cada série que você escolher. - Pôsteres e imagens de fundo (backdrop) de `https://img.amodb.dev/t/p/{size}/{file}`. ## Quais dados você recebe | Você precisa de | Chamada ou campo | Observações | | --------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------- | | Séries de anime | `GET /3/discover/tv` com `with_genres=16` e `with_original_language=ja` | `results` traz `name`, `original_name`, `first_air_date`, `genre_ids` | | Filmes de anime | `GET /3/discover/movie` com os mesmos dois filtros | `title`, `original_title`, `release_date` | | O ID da palavra-chave anime | `GET /3/search/keyword?query=anime` | Array `results` com `id` e `name` | | Lista de episódios | `GET /3/tv/{series_id}/season/{season_number}` | Uma chamada por temporada | | Título em japonês | `original_name` ou `original_title` | Escrita original, como armazenada | | Pôster | `poster_path` | Anexe ao host de imagens, sem chave | ## Comece em 3 passos 1. Escolha um plano em [preços](https://amodb.dev/pt/pricing/). Todos os dados estão em todos os planos, só o limite muda: 20, 40 ou 120 requisições por minuto. 2. Crie uma chave no painel da sua conta. 3. Consulte o ID da palavra-chave uma vez, depois chame o discover com ele e os dois filtros. ## Exemplo de requisição O script em Python encontra o ID da palavra-chave anime e depois lista as séries animadas japonesas mais populares marcadas com ela. A chamada curl logo depois dispensa a palavra-chave e lista uma única temporada de exibição por janela de datas. ```bash curl -s "https://api.amodb.dev/3/discover/tv?with_genres=16&with_original_language=ja&first_air_date.gte=2026-10-01&first_air_date.lte=2026-12-31&sort_by=popularity.desc" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```python import os import requests BASE = "https://api.amodb.dev/3" session = requests.Session() session.headers["Authorization"] = f"Bearer {os.environ['AMODB_KEY']}" def get(path, **params): r = session.get(BASE + path, params=params, timeout=10) r.raise_for_status() return r.json() keywords = get("/search/keyword", query="anime")["results"] anime_id = next((k["id"] for k in keywords if k["name"].lower() == "anime"), None) if anime_id is None: raise SystemExit("anime keyword not found") page = get( "/discover/tv", with_genres=16, with_original_language="ja", with_keywords=anime_id, sort_by="popularity.desc", language="en-US", page=1, ) for show in page["results"]: print(show.get("first_air_date"), show["name"], "/", show["original_name"]) ``` Uma resposta reduzida da chamada em Python acima: 2 dos 19 resultados da página 1, com arrays cortados para 2 itens. ```json { "page": 1, "results": [ { "adult": false, "backdrop_path": "/dmptwhmqxcMrCKgyvBlTt18PgDu.jpg", "first_air_date": "2005-04-22", "genre_ids": [ 10759, 16 ], "id": 65733, "name": "Doraemon", "origin_country": [ "JP" ], "original_language": "ja", "original_name": "ドラえもん", "overview": "Robotic cat Doraemon is sent back in time from the 22nd century to protect 10-year-old...", "popularity": 301.2214, "poster_path": "/9ZN1P32SHviL3SV51qLivxycvcx.jpg", "vote_average": 8.089, "vote_count": 252 }, { "adult": false, "backdrop_path": "/mFKys64gbDQrFqwUheGwXQwo2JK.jpg", "first_air_date": "2004-10-05", "genre_ids": [ 10759, 16 ], "id": 30984, "name": "Bleach", "origin_country": [ "JP" ], "original_language": "ja", "original_name": "BLEACH", "overview": "For as long as he can remember, Ichigo Kurosaki has been able to see ghosts. But when h...", "popularity": 190.3257, "poster_path": "/2EewmxXe72ogD0EaWM8gqa0ccIw.jpg", "vote_average": 8.4, "vote_count": 2295 } ], "total_pages": 216, "total_results": 4302 } ``` ## Filtros que moldam uma lista de anime | Filtro | Valor | Efeito | | ------------------------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | `with_genres` | `16` | Animação. Uma vírgula significa E, então `16,35` é animação e comédia. | | `without_genres` | ID de gênero | Exclui os títulos que têm esse gênero. | | `with_original_language` | `ja` | Apenas originais em japonês. | | `with_keywords` | ID de palavra-chave | Apenas títulos marcados com a palavra-chave. Títulos sem a marca ficam de fora. | | `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD` | Uma janela de exibição para séries. Os filmes usam `primary_release_date.gte` e `.lte`. | | `sort_by` | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Ordem. Combine `vote_average.desc` com `vote_count.gte` para que amostras minúsculas não fiquem em primeiro. | | `page` | 1 a 500 | Até 20 resultados por página. | A marcação por palavra-chave é parcial. Se uma lista parecer curta, retire `with_keywords` e mantenha os filtros de gênero e idioma para ampliar o alcance. A lista completa de filtros está em [discover](https://amodb.dev/pt/discover/), e os IDs de palavras-chave são explicados em [palavras-chave](https://amodb.dev/pt/keywords/). ## Filmes de anime e séries longas Os filmes usam os mesmos dois filtros no endpoint de filmes. Esta chamada lista filmes de animação japoneses bem avaliados, e `vote_count.gte` exclui títulos com apenas alguns votos. ```bash curl -s "https://api.amodb.dev/3/discover/movie?with_genres=16&with_original_language=ja&sort_by=vote_average.desc&vote_count.gte=200" \ -H "Authorization: Bearer $AMODB_KEY" ``` Cada resultado tem `title`, `original_title`, `release_date` e `poster_path`. Séries de longa duração costumam ser divididas em várias temporadas no catálogo. `GET /3/tv/{series_id}/episode_groups` lista outras ordenações com seus nomes e contagens de episódios quando são conhecidos, mas o amodb não serve os grupos em si, e `number_of_episodes` na série dá o total. As chamadas de temporada estão descritas em [API de séries de TV](https://amodb.dev/pt/tv-show-api/). ## Títulos e idiomas No anime, o título original é o que mais importa, então guarde os dois campos. | Campo | Contém | Uso | | ------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------- | | `name` | Título no idioma que você pediu | Rótulo principal na sua interface | | `original_name` | Título no idioma original, escrita japonesa nos originais japoneses | Rótulo secundário, útil para fãs que conhecem o título em japonês | | `original_language` | `ja` | Filtre do seu lado se misturar fontes | | `overview` | Texto localizado, vazio quando não existe tradução | Peça de novo com `language=en-US` quando estiver vazio | `GET /3/tv/{series_id}/alternative_titles` lista outros títulos por país quando são conhecidos. Os 14 idiomas atendidos estão listados em [idiomas](https://amodb.dev/pt/languages/). ## Como se compara | Recurso | Scraping de sites de fãs | API de banco de dados só de anime | amodb | | --------------------------- | ------------------------ | ------------------------------------------------------- | -------------------------------------------------------------- | | Escopo | O que o site cobrir | Só anime, veja a documentação para saber a profundidade | Filmes e séries em um só catálogo, anime escolhido por filtros | | Seleção de anime | Categorias do site | Consulte a documentação | Gênero 16, `with_original_language=ja`, palavra-chave anime | | Título no idioma original | Varia | Consulte a documentação | `original_name` e `original_title` | | Listas de episódios | Extraídas das páginas | Consulte a documentação | Chamada de temporada com um array `episodes` | | Idioma de interface japonês | Depende do site | Consulte a documentação | Não atendido, apenas títulos originais | | Termos de acesso | Os termos de cada site | Planos gratuitos e pagos variam | Pago, pré-pago, sem plano gratuito | ## Preços Uma lista de anime são poucas chamadas ao discover, e os resultados do discover ficam no cache de borda por 30 minutos, então 20 requisições por minuto bastam para muitos apps. Os planos oferecem 20, 40 ou 120 requisições por minuto com os mesmos dados. Pague por 1, 3, 6, 12 ou 24 meses, com 0, 10, 20, 30 e 40 por cento de desconto, e sem renovação automática. Não há plano gratuito. Escolha um plano em [preços](https://amodb.dev/pt/pricing/). ## Perguntas e respostas ### O amodb tem um endpoint dedicado a anime? Não. Anime é um filtro nos endpoints discover normais: with_genres=16 para Animação e with_original_language=ja para originais japoneses. Adicione o ID da palavra-chave anime para uma lista mais precisa. ### Consigo obter títulos e sinopses em japonês? Os originais japoneses mantêm o título em japonês em original_name nas séries e em original_title nos filmes. O japonês não é um dos 14 idiomas de interface atendidos, então name e overview seguem a sua tag de idioma ou o inglês. ### Como encontro o ID da palavra-chave anime? Chame /3/search/keyword?query=anime e leia o id do resultado chamado anime. Passe-o como with_keywords no discover. Guarde o ID depois da primeira consulta, porque as buscas de palavras-chave ficam em cache por apenas 10 minutos. ### O gênero 16 retorna só anime? Não. O gênero 16 é Animação, que também cobre desenhos animados de outros países. Adicionar with_original_language=ja elimina a maioria deles, e a palavra-chave anime estreita ainda mais a lista. ### Até que profundidade posso paginar uma lista de anime? As páginas vão de 1 a 500, com até 20 resultados cada, então uma consulta alcança cerca de 10,000 resultados. Divida listas maiores em janelas de first_air_date.gte e first_air_date.lte. Os resultados do discover ficam em cache por 30 minutos. ## Páginas relacionadas - [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. - [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. - [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. - [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. - [API de séries de TV: séries, temporadas e episódios](https://amodb.dev/pt/tv-show-api/): API de séries de TV com status, emissoras, temporadas, episódios e next_episode_to_air. JSON do TMDB v3 em 14 idiomas, a partir de 20 requisições por minuto. - [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. Atualizado: 2026-10-18. Source: https://amodb.dev/pt/anime-api/