API anime con i filtri discover

Trovare gli anime con il genere 16 e la lingua originale ja

amodb non ha un endpoint anime separato. Gli anime sono un filtro su GET /3/discover/tv e GET /3/discover/movie: with_genres=16 (animazione) più with_original_language=ja. Aggiungi l'ID della parola chiave anime, che trovi con GET /3/search/keyword, per tenere solo i titoli etichettati come anime.

Un limite da conoscere: il giapponese non è una delle 14 lingue dell'interfaccia servite da amodb. Titoli e trame tornano nella lingua richiesta, oppure in inglese. Il titolo giapponese resta in original_name per le serie e in original_title per i film.

Cosa ottieni:

• Serie e film anime con gli stessi filtri discover.
• I titoli originali giapponesi accanto a quelli localizzati.
• Elenchi di stagioni ed episodi per ogni serie che scegli.
• Locandine e immagini di sfondo da https://img.amodb.dev/t/p/{size}/{file}.

Quali dati ottieni

Parti in 3 passaggi

1. Scegli un piano nella pagina dei prezzi. Tutti i dati sono in ogni piano, cambia solo la frequenza: 20, 40 o 120 richieste al minuto.
2. Crea una chiave nella dashboard del tuo account.
3. Cerca una volta l'ID della parola chiave, poi chiama discover con quello e i due filtri.

Esempio di richiesta

Lo script Python trova l'ID della parola chiave anime, poi elenca le serie animate giapponesi più popolari che la portano. La chiamata curl sotto salta la parola chiave ed elenca una singola stagione di messa in onda con una finestra di date.

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"])

Una risposta ridotta per la chiamata Python qui sopra: 2 dei 19 risultati della pagina 1, con gli array tagliati a 2 elementi.

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

I filtri che danno forma a una lista di anime

L'etichettatura con parole chiave è parziale. Se una lista sembra corta, togli with_keywords e tieni i filtri di genere e lingua per una rete più larga. L'elenco completo dei filtri è nella pagina discover, e gli ID delle parole chiave sono spiegati nella pagina parole chiave.

Film anime e serie lunghe

I film usano gli stessi due filtri sull'endpoint dei film. Questa chiamata elenca i film d'animazione giapponesi ben votati, e vote_count.gte esclude i titoli con una manciata di voti.

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"

Ogni risultato ha title, original_title, release_date e poster_path. Le serie molto lunghe sono spesso divise in più stagioni nel catalogo. GET /3/tv/{series_id}/episode_groups elenca altri ordinamenti con nomi e numero di episodi quando sono noti, ma amodb non serve i gruppi stessi, e number_of_episodes sulla serie dà il totale. Le chiamate delle stagioni sono descritte nella pagina API per serie TV.

Titoli e lingue

Gli anime sono il caso in cui il titolo originale conta di più, quindi tieni entrambi i campi.

GET /3/tv/{series_id}/alternative_titles elenca altri titoli per paese quando sono noti. Le 14 lingue servite sono elencate nella pagina lingue.

Confronto

Prezzi

Un elenco di anime richiede poche chiamate discover, e i risultati di discover restano nella cache edge per 30 minuti, quindi 20 richieste al minuto bastano a molte app. I piani sono da 20, 40 o 120 richieste al minuto con gli stessi dati. Paga per 1, 3, 6, 12 o 24 mesi, con uno sconto di 0, 10, 20, 30 e 40 per cento, e senza rinnovo automatico. Non esiste un piano gratuito. Scegli un piano nella pagina dei prezzi.