Anime API s filtry discover

Najděte anime přes žánr 16 a původní jazyk ja

amodb nemá samostatný endpoint pro anime. Anime je filtr na GET /3/discover/tv a GET /3/discover/movie: with_genres=16 (animace) plus with_original_language=ja. Přidejte ID klíčového slova anime, které zjistíte přes GET /3/search/keyword, aby zůstaly jen tituly označené jako anime.

Jedno poctivé omezení: japonština není jedním ze 14 jazyků rozhraní, které amodb podporuje. Názvy a popisy se vrátí v jazyce, o který požádáte, nebo anglicky. Japonský název zůstává v original_name u seriálů a v original_title u filmů.

Co dostanete:

• Anime seriály i anime filmy ze stejných filtrů discover.
• Původní japonské názvy vedle lokalizovaných.
• Seznamy sezón a epizod pro každý vybraný seriál.
• Plakáty a pozadí z https://img.amodb.dev/t/p/{size}/{file}.

Jaká data dostanete

Začněte ve 3 krocích

1. Vyberte tarif na stránce ceník. Všechna data jsou v každém tarifu, liší se jen rychlost: 20, 40 nebo 120 požadavků za minutu.
2. Vytvořte klíč v panelu účtu.
3. ID klíčového slova zjistěte jednou, pak zavolejte discover s ním a se dvěma filtry.

Příklad požadavku

Skript v Pythonu najde ID klíčového slova anime a pak vypíše nejpopulárnější japonské animované seriály s ním označené. Volání curl pod ním klíčové slovo vynechá a vypíše jednu vysílací sezónu podle okna dat.

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

Zkrácená odpověď na volání v Pythonu výše: 2 z 19 výsledků na stránce 1, pole zkrácená na 2 položky.

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

Filtry, které tvarují seznam anime

Značkování klíčovými slovy je neúplné. Pokud je seznam krátký, vynechte with_keywords a ponechte filtry žánru a jazyka pro širší záběr. Úplný seznam filtrů je na stránce discover a ID klíčových slov vysvětluje stránka klíčová slova.

Anime filmy a dlouhé seriály

Filmy používají stejné dva filtry na endpointu pro filmy. Toto volání vypíše dobře hodnocené japonské animované filmy a vote_count.gte vyřadí tituly s hrstkou hlasů.

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"

Každý výsledek má title, original_title, release_date a poster_path. Dlouho vysílané seriály jsou v katalogu často rozdělené na několik sezón. GET /3/tv/{series_id}/episode_groups uvádí jiná řazení s názvy a počty epizod tam, kde jsou známé, ale amodb samotné skupiny neposkytuje a celkový počet udává number_of_episodes u seriálu. Volání sezón jsou popsána na stránce API pro seriály.

Názvy a jazyky

Anime je případ, kdy na původním názvu záleží nejvíc, proto ponechte obě pole.

GET /3/tv/{series_id}/alternative_titles uvádí další názvy podle zemí, kde jsou známé. Všech 14 podporovaných jazyků je uvedeno na stránce jazyky.

Jak si stojí v porovnání

Ceník

Seznam anime je pár volání discover a výsledky discover zůstávají v cache na edge 30 minut, takže 20 požadavků za minutu stačí mnoha aplikacím. Tarify mají 20, 40 nebo 120 požadavků za minutu se stejnými daty. Platíte za 1, 3, 6, 12 nebo 24 měsíců se slevou 0, 10, 20, 30 a 40 procent a bez automatického obnovení. Bezplatný tarif neexistuje. Vyberte tarif na stránce ceník.