API anime z filtrami discover

Znajdź anime przez gatunek 16 i język oryginału ja

amodb nie ma osobnego endpointu dla anime. Anime to filtr na GET /3/discover/tv i GET /3/discover/movie: with_genres=16 (animacja) plus with_original_language=ja. Dodaj ID słowa kluczowego anime, które sprawdzisz przez GET /3/search/keyword, aby zostały tylko tytuły oznaczone jako anime.

Jedno uczciwe ograniczenie: japoński nie należy do 14 języków interfejsu, które obsługuje amodb. Tytuły i opisy wracają w języku, o który prosisz, albo po angielsku. Japoński tytuł zostaje w original_name dla seriali i w original_title dla filmów.

Co dostajesz:

• Seriale anime i filmy anime z tych samych filtrów discover.
• Oryginalne japońskie tytuły obok zlokalizowanych.
• Listy sezonów i odcinków dla każdego wybranego serialu.
• Plakaty i tła z https://img.amodb.dev/t/p/{size}/{file}.

Jakie dane dostajesz

Start w 3 krokach

1. Wybierz plan na stronie cennik. Wszystkie dane są w każdym planie, różni się tylko tempo: 20, 40 lub 120 żądań na minutę.
2. Utwórz klucz w panelu konta.
3. Sprawdź ID słowa kluczowego raz, potem wywołaj discover z nim i z dwoma filtrami.

Przykładowe żądanie

Skrypt w Pythonie znajduje ID słowa kluczowego anime, a potem wypisuje najpopularniejsze japońskie seriale animowane z tym oznaczeniem. Wywołanie curl pod nim pomija słowo kluczowe i wypisuje jeden sezon emisji według 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"])

Przycięta odpowiedź na wywołanie w Pythonie powyżej: 2 z 19 wyników na stronie 1, tablice przycięte do 2 pozycji.

{
  "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 kształtujące listę anime

Oznaczanie słowami kluczowymi jest częściowe. Jeśli lista wygląda na krótką, usuń with_keywords i zostaw filtry gatunku i języka, by zarzucić szerszą sieć. Pełna lista filtrów jest na stronie discover, a ID słów kluczowych wyjaśnia strona słowa kluczowe.

Filmy anime i długie seriale

Filmy używają tych samych dwóch filtrów na endpoincie filmów. To wywołanie wypisuje dobrze oceniane japońskie filmy animowane, a vote_count.gte odsiewa tytuły z garstką głosów.

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żdy wynik ma title, original_title, release_date i poster_path. Długo emitowane seriale są w katalogu często podzielone na kilka sezonów. GET /3/tv/{series_id}/episode_groups wymienia inne układy z nazwami i liczbą odcinków tam, gdzie są znane, ale amodb nie udostępnia samych grup, a łączną liczbę podaje number_of_episodes w serialu. Wywołania sezonów opisuje strona API seriali.

Tytuły i języki

Anime to przypadek, w którym oryginalny tytuł liczy się najbardziej, więc zachowaj oba pola.

GET /3/tv/{series_id}/alternative_titles wymienia inne tytuły według krajów, gdzie są znane. 14 obsługiwanych języków jest wymienionych na stronie języki.

Jak wypada w porównaniu

Cennik

Lista anime to kilka wywołań discover, a wyniki discover zostają w cache na edge przez 30 minut, więc 20 żądań na minutę wystarcza wielu aplikacjom. Plany mają 20, 40 lub 120 żądań na minutę z tymi samymi danymi. Płacisz za 1, 3, 6, 12 lub 24 miesiące ze zniżką 0, 10, 20, 30 i 40 procent, bez automatycznego odnawiania. Nie ma darmowego planu. Wybierz plan na stronie cennik.