API de anime com filtros do discover

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

Comece em 3 passos

1. Escolha um plano em preços. 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.

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"

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.

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

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, e os IDs de palavras-chave são explicados em palavras-chave.

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.

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.

Títulos e idiomas

No anime, o título original é o que mais importa, então guarde os dois campos.

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.

Como se compara

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.