API לאנימה עם מסנני discover

מציאת אנימה עם ז'אנר 16 ושפת מקור ja

ל-amodb אין נקודת קצה נפרדת לאנימה. אנימה היא מסנן על GET /3/discover/tv ועל GET /3/discover/movie: הפרמטר with_genres=16 (אנימציה) יחד עם with_original_language=ja. הוסיפו את המזהה של מילת המפתח anime, שמוצאים באמצעות GET /3/search/keyword, כדי להשאיר רק כותרים שסומנו כאנימה.

מגבלה אחת, בכנות: יפנית אינה אחת מ-14 שפות הממשק ש-amodb מגיש. כותרות ותקצירים חוזרים בשפה שביקשתם, או באנגלית. הכותרת ביפנית נשארת ב-original_name לסדרות וב-original_title לסרטים.

מה מקבלים:

• סדרות אנימה וסרטי אנימה מאותם מסנני discover.
• כותרות מקוריות ביפנית לצד הכותרות המתורגמות.
• רשימות עונות ופרקים לכל סדרה שבחרתם.
• פוסטרים ותמונות רקע מ-https://img.amodb.dev/t/p/{size}/{file}.

אילו נתונים מקבלים

מתחילים בשלושה שלבים

1. בחרו מסלול בעמוד תמחור. כל הנתונים בכל מסלול, רק הקצב שונה: 20, 40 או 120 בקשות לדקה.
2. צרו מפתח בלוח הבקרה של החשבון.
3. חפשו את מזהה מילת המפתח פעם אחת, ואז קראו ל-discover איתו ועם שני המסננים.

בקשה לדוגמה

סקריפט ה-Python מוצא את מזהה מילת המפתח 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 והשאירו את מסנני הז'אנר והשפה לרשת רחבה יותר. רשימת המסננים המלאה נמצאת בעמוד גילוי, ומזהי מילות מפתח מוסברים בעמוד מילות מפתח.

סרטי אנימה וסדרות ארוכות

לסרטים משתמשים באותם שני מסננים בנקודת הקצה של סרטים. הקריאה הזו מציגה סרטי אנימציה יפניים בעלי דירוג גבוה, ו-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 נשארות במטמון הקצה 30 דקות, ולכן 20 בקשות לדקה מספיקות לאפליקציות רבות. המסלולים הם 20, 40 או 120 בקשות לדקה עם אותם נתונים. משלמים על 1, 3, 6, 12 או 24 חודשים, עם 0, 10, 20, 30 ו-40 אחוז הנחה, וללא חידוש אוטומטי. אין מסלול חינמי. בחרו מסלול בעמוד תמחור.