API за аниме с филтри на discover

Намиране на аниме с жанр 16 и оригинален език ja

amodb няма отделен ендпойнт за аниме. Анимето е филтър на GET /3/discover/tv и GET /3/discover/movie: with_genres=16 (Animation) плюс with_original_language=ja. Добавете id на ключовата дума anime, което намирате с GET /3/search/keyword, за да останат само заглавията, отбелязани като аниме.

Едно честно ограничение: японският не е сред 14-те езика на интерфейса, които amodb обслужва. Заглавията и описанията се връщат на езика, който поискате, или на английски. Японското заглавие остава в original_name за сериали и original_title за филми.

Какво получавате:

• Аниме сериали и пълнометражни аниме филми от същите филтри на discover.
• Оригинални японски заглавия до локализираните.
• Списъци със сезони и епизоди за всеки избран сериал.
• Постери и фонови изображения от https://img.amodb.dev/t/p/{size}/{file}.

Какви данни получавате

Започнете в 3 стъпки

1. Изберете план на страницата с цените. Всички данни са във всеки план, различава се само скоростта: 20, 40 или 120 заявки в минута.
2. Създайте ключ в личния си профил.
3. Намерете id на ключовата дума веднъж, после извикайте discover с него и двата филтъра.

Пример със заявка

Python скриптът намира id на ключовата дума anime, после изброява най-популярните японски анимационни сериали, отбелязани с нея. Извикването с curl под него пропуска ключовата дума и изброява един сезон на излъчване по прозорец от дати.

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

Съкратен отговор за Python извикването по-горе: 2 от 19-те резултата на страница 1, с масиви, съкратени до 2 елемента.

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

Филтри, които оформят списък с аниме

Етикетирането с ключови думи е частично. Ако списъкът изглежда кратък, махнете with_keywords и оставете филтрите за жанр и език за по-широк обхват. Пълният списък с филтри е на страницата откриване по филтри, а id на ключови думи са обяснени на страницата ключови думи.

Аниме филми и дълги сериали

Филмите ползват същите два филтъра на ендпойнта за филми. Това извикване изброява добре оценени японски анимационни филми, а vote_count.gte отстранява заглавия с шепа гласове.

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"

Всеки резултат има title, original_title, release_date и poster_path. Дългогодишните сериали в каталога често са разделени на няколко сезона. GET /3/tv/{series_id}/episode_groups изброява други подредби с имената им и броя епизоди, където са известни, но amodb не обслужва самите групи, а number_of_episodes на сериала дава общия брой. Извикванията за сезони са описани на страницата API за сериали.

Заглавия и езици

Анимето е случаят, в който оригиналното заглавие значи най-много, затова пазете и двете полета.

GET /3/tv/{series_id}/alternative_titles изброява други заглавия по държави, където са известни. 14-те обслужвани езика са изброени на страницата езици.

Как се сравнява

Цени

Списък с аниме са няколко извиквания на discover, а резултатите от discover остават в edge кеша 30 минути, така че 20 заявки в минута стигат за много приложения. Плановете са за 20, 40 или 120 заявки в минута със същите данни. Плащате за 1, 3, 6, 12 или 24 месеца с отстъпка 0, 10, 20, 30 и 40 процента и без автоматично подновяване. Няма безплатен план. Изберете план на страницата с цените.