# API anime con i filtri discover > amodb non ha un endpoint anime separato. Elenca gli anime con /3/discover/tv o /3/discover/movie usando il genere 16 e with_original_language=ja, poi restringi con l'ID della parola chiave anime da /3/search/keyword. Il giapponese non è una lingua dell'interfaccia servita, ma original_name conserva il titolo giapponese. ## 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 | Ti serve | Chiamata o campo | Note | | ------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------- | | Serie anime | `GET /3/discover/tv` con `with_genres=16` e `with_original_language=ja` | `results` contiene `name`, `original_name`, `first_air_date`, `genre_ids` | | Film anime | `GET /3/discover/movie` con gli stessi due filtri | `title`, `original_title`, `release_date` | | L'ID della parola chiave anime | `GET /3/search/keyword?query=anime` | Array `results` di `id` e `name` | | Elenco degli episodi | `GET /3/tv/{series_id}/season/{season_number}` | Una chiamata per stagione | | Titolo giapponese | `original_name` o `original_title` | Scrittura originale, come salvata | | Locandina | `poster_path` | Da accodare all'host delle immagini, senza chiave | ## Parti in 3 passaggi 1. Scegli un piano nella pagina dei [prezzi](https://amodb.dev/it/pricing/). 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. ```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"]) ``` Una risposta ridotta per la chiamata Python qui sopra: 2 dei 19 risultati della pagina 1, con gli array tagliati a 2 elementi. ```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 } ``` ## I filtri che danno forma a una lista di anime | Filtro | Valore | Effetto | | ------------------------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | `with_genres` | `16` | Animazione. Una virgola significa AND, quindi `16,35` è animazione e commedia. | | `without_genres` | ID del genere | Esclude i titoli che hanno quel genere. | | `with_original_language` | `ja` | Solo originali giapponesi. | | `with_keywords` | ID della parola chiave | Solo i titoli etichettati con la parola chiave. I titoli senza etichetta vengono persi. | | `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD` | Una finestra di messa in onda per le serie. I film usano `primary_release_date.gte` e `.lte`. | | `sort_by` | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | Ordinamento. Abbina `vote_average.desc` a `vote_count.gte` perché i campioni minuscoli non finiscano in cima. | | `page` | da 1 a 500 | Fino a 20 risultati per pagina. | 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](https://amodb.dev/it/discover/), e gli ID delle parole chiave sono spiegati nella pagina [parole chiave](https://amodb.dev/it/keywords/). ## 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. ```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" ``` 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](https://amodb.dev/it/tv-show-api/). ## Titoli e lingue Gli anime sono il caso in cui il titolo originale conta di più, quindi tieni entrambi i campi. | Campo | Contiene | Uso | | ------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | `name` | Titolo nella lingua richiesta | Etichetta principale nella tua interfaccia | | `original_name` | Titolo nella lingua originale, scrittura giapponese per gli originali giapponesi | Etichetta secondaria, utile ai fan che conoscono il titolo giapponese | | `original_language` | `ja` | Filtro dal tuo lato se mescoli più fonti | | `overview` | Testo localizzato, vuoto quando non esiste una traduzione | Richiedi di nuovo con `language=en-US` quando è vuoto | `GET /3/tv/{series_id}/alternative_titles` elenca altri titoli per paese quando sono noti. Le 14 lingue servite sono elencate nella pagina [lingue](https://amodb.dev/it/languages/). ## Confronto | Funzionalità | Fare scraping dei siti di fan | API di database solo anime | amodb | | -------------------------- | ----------------------------- | ---------------------------------------------------- | -------------------------------------------------------------- | | Ambito | Quello che copre il sito | Solo anime, per la profondità vedi la documentazione | Film e serie TV in un solo catalogo, anime scelti con i filtri | | Selezione degli anime | Categorie del sito | Vedi la documentazione | Genere 16, `with_original_language=ja`, parola chiave anime | | Titolo in lingua originale | Variabile | Vedi la documentazione | `original_name` e `original_title` | | Elenchi di episodi | Estratti dalle pagine | Vedi la documentazione | Chiamata di stagione con un array `episodes` | | Interfaccia in giapponese | Dipende dal sito | Vedi la documentazione | Non servita, solo titoli originali | | Condizioni di accesso | Le condizioni di ogni sito | Livelli gratuiti e a pagamento variabili | A pagamento, prepagato, nessun piano gratuito | ## 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](https://amodb.dev/it/pricing/). ## Domande e risposte ### amodb ha un endpoint anime dedicato? No. Gli anime sono un filtro dei normali endpoint discover: with_genres=16 per l'animazione e with_original_language=ja per gli originali giapponesi. Aggiungi l'ID della parola chiave anime per una lista più mirata. ### Posso ottenere titoli e trame in giapponese? Gli originali giapponesi mantengono il titolo giapponese in original_name per le serie e in original_title per i film. Il giapponese non è una delle 14 lingue dell'interfaccia servite, quindi name e overview seguono il tuo tag di lingua o l'inglese. ### Come trovo l'ID della parola chiave anime? Chiama /3/search/keyword?query=anime e leggi l'id del risultato chiamato anime. Passalo come with_keywords su discover. Salva l'id dopo la prima ricerca, perché le ricerche di parole chiave restano in cache solo 10 minuti. ### Il genere 16 restituisce solo anime? No. Il genere 16 è Animazione, che copre anche i cartoni animati di altri paesi. Aggiungere with_original_language=ja ne elimina la maggior parte, e la parola chiave anime restringe ancora la lista. ### Fino a che punto posso paginare una lista di anime? Le pagine vanno da 1 a 500 con fino a 20 risultati ciascuna, quindi una query arriva a circa 10.000 risultati. Dividi le liste più grandi in finestre first_air_date.gte e first_air_date.lte. I risultati di discover restano in cache 30 minuti. ## Pagine correlate - [API Discover](https://amodb.dev/it/discover/): API Discover con gli stessi filtri di TMDB v3. Elenca film e serie TV per genere, cast, società, parola chiave, anno, voto, durata e piattaforma. - [API delle parole chiave](https://amodb.dev/it/keywords/): API parole chiave con percorsi TMDB v3: elenca i tag di trama di un film o serie, cerca una parola chiave, i suoi film e combina with_keywords con discover. - [Generi e liste di riferimento](https://amodb.dev/it/genres/): API generi con percorsi TMDB v3: ID dei generi di film e serie TV con nomi tradotti, più liste di paesi, lingue, mestieri, classificazioni e piattaforme. - [Lingue](https://amodb.dev/it/languages/): amodb serve titoli, trame e nomi in 14 lingue. Passa un tag in stile TMDB come ru-RU o pt-BR in language; qualsiasi altro tag ripiega sull'inglese. - [API per serie TV, stagioni ed episodi](https://amodb.dev/it/tv-show-api/): API serie TV con stato, emittenti, stagioni, episodi e next_episode_to_air. JSON compatibile TMDB v3 in 14 lingue, da 20 richieste al minuto. - [Avvio rapido](https://amodb.dev/it/quickstart/): Fai la prima chiamata ad amodb: ottieni una chiave, richiedi i dettagli di un film in curl, JavaScript, Python, PHP o Go, carica la locandina. Meno di 2 minuti. Aggiornato: 2026-10-18. Source: https://amodb.dev/it/anime-api/