API anime cu filtre discover

Găsește anime cu genul 16 și limba originală ja

amodb nu are un endpoint separat pentru anime. Anime este un filtru pe GET /3/discover/tv și GET /3/discover/movie: with_genres=16 (Animație) plus with_original_language=ja. Adaugă ID-ul cuvântului-cheie anime, pe care îl cauți cu GET /3/search/keyword, ca să păstrezi doar titlurile etichetate ca anime.

O limită spusă deschis: japoneza nu este una dintre cele 14 limbi de interfață pe care le servește amodb. Titlurile și descrierile revin în limba pe care o ceri sau în engleză. Titlul japonez rămâne în original_name pentru seriale și în original_title pentru filme.

Ce primești:

• Seriale anime și filme anime din aceleași filtre discover.
• Titluri originale japoneze alături de cele localizate.
• Liste de sezoane și episoade pentru fiecare serial ales.
• Postere și imagini de fundal de la https://img.amodb.dev/t/p/{size}/{file}.

Ce date primești

Începe în 3 pași

1. Alege un plan la prețuri. Toate datele sunt în fiecare plan, diferă doar ritmul: 20, 40 sau 120 de cereri pe minut.
2. Creează o cheie în panoul contului tău.
3. Caută o singură dată ID-ul cuvântului-cheie, apoi apelează discover cu el și cu cele două filtre.

Exemplu de cerere

Scriptul Python găsește ID-ul cuvântului-cheie anime, apoi listează cele mai populare seriale animate japoneze etichetate cu el. Apelul curl de sub el sare peste cuvântul-cheie și listează un singur sezon de difuzare, pe fereastră de 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"])

Un răspuns scurtat pentru apelul Python de mai sus: 2 din cele 19 rezultate de pe pagina 1, cu array-urile tăiate la 2 elemente.

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

Filtre care modelează o listă de anime

Etichetarea cu cuvinte-cheie este parțială. Dacă o listă pare scurtă, renunță la with_keywords și păstrează filtrele de gen și de limbă pentru o plasă mai largă. Lista completă de filtre este la descoperire, iar ID-urile cuvintelor-cheie sunt explicate la cuvinte-cheie.

Filme anime și seriale lungi

Filmele folosesc aceleași două filtre pe endpoint-ul pentru filme. Acest apel listează filme animate japoneze bine cotate, iar vote_count.gte exclude titlurile cu doar câteva voturi.

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"

Fiecare rezultat are title, original_title, release_date și poster_path. Serialele lungi sunt adesea împărțite în mai multe sezoane în catalog. GET /3/tv/{series_id}/episode_groups listează alte ordini cu numele și numărul de episoade, acolo unde sunt cunoscute, dar amodb nu servește grupurile în sine, iar number_of_episodes din serial dă totalul. Apelurile pentru sezoane sunt descrise la API pentru seriale TV.

Titluri și limbi

Anime este cazul în care titlul original contează cel mai mult, așa că păstrează ambele câmpuri.

GET /3/tv/{series_id}/alternative_titles listează alte titluri pe țări, acolo unde sunt cunoscute. Cele 14 limbi servite sunt listate la limbi.

Cum se compară

Prețuri

O listă de anime înseamnă câteva apeluri discover, iar rezultatele discover rămân în cache-ul de la margine 30 de minute, așa că 20 de cereri pe minut ajung pentru multe aplicații. Planurile vin cu 20, 40 sau 120 de cereri pe minut, cu aceleași date. Plătești pentru 1, 3, 6, 12 sau 24 de luni, cu reduceri de 0, 10, 20, 30 și 40 la sută și fără reînnoire automată. Nu există nivel gratuit. Alege un plan la prețuri.