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

> ל-amodb אין נקודת קצה נפרדת לאנימה. מציגים אנימה עם /3/discover/tv או /3/discover/movie, ז'אנר 16 ו-with_original_language=ja, ומצמצמים עם מזהה מילת המפתח anime מ-/3/search/keyword. יפנית אינה שפת ממשק מוגשת, אבל original_name שומר את הכותרת ביפנית, ולכן אפשר להציג אותה לצד השם המתורגם.

## מציאת אנימה עם ז'אנר 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}`.

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

| מה שצריך              | קריאה או שדה                                                           | הערות                                                                 |
| --------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------- |
| סדרות אנימה           | `GET /3/discover/tv` עם `with_genres=16` ו-`with_original_language=ja` | ב-`results` יש `name`, `original_name`, `first_air_date`, `genre_ids` |
| סרטי אנימה            | `GET /3/discover/movie` עם אותם שני מסננים                             | `title`, `original_title`, `release_date`                             |
| מזהה מילת המפתח anime | `GET /3/search/keyword?query=anime`                                    | מערך `results` של `id` ו-`name`                                       |
| רשימת פרקים           | `GET /3/tv/{series_id}/season/{season_number}`                         | קריאה אחת לכל עונה                                                    |
| כותרת ביפנית          | `original_name` או `original_title`                                    | כתב מקורי, כפי שנשמר                                                  |
| פוסטר                 | `poster_path`                                                          | מצרפים למארח התמונות, בלי מפתח                                        |

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

1. בחרו מסלול בעמוד [תמחור](https://amodb.dev/he/pricing/). כל הנתונים בכל מסלול, רק הקצב שונה: 20, 40 או 120 בקשות לדקה.
2. צרו מפתח בלוח הבקרה של החשבון.
3. חפשו את מזהה מילת המפתח פעם אחת, ואז קראו ל-discover איתו ועם שני המסננים.

## בקשה לדוגמה

סקריפט ה-Python מוצא את מזהה מילת המפתח anime, ואז מציג את סדרות האנימציה היפניות הפופולריות ביותר שסומנו בה. קריאת ה-curl שמתחתיו מדלגת על מילת המפתח ומציגה עונת שידור אחת לפי חלון תאריכים.

```bash
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"
```

```python
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 פריטים.

```json
{
  "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_genres`                              | `16`                                                          | אנימציה. פסיק פירושו AND, ולכן `16,35` הוא אנימציה וקומדיה.                                |
| `without_genres`                           | מזהה ז'אנר                                                    | מסיר כותרים שנושאים את הז'אנר הזה.                                                         |
| `with_original_language`                   | `ja`                                                          | מקורות יפניים בלבד.                                                                        |
| `with_keywords`                            | מזהה מילת מפתח                                                | רק כותרים שסומנו במילת המפתח. כותרים בלי התג מפוספסים.                                     |
| `first_air_date.gte`, `first_air_date.lte` | `YYYY-MM-DD`                                                  | חלון שידור לסדרות. לסרטים משתמשים ב-`primary_release_date.gte` וב-`.lte`.                  |
| `sort_by`                                  | `popularity.desc`, `vote_average.desc`, `first_air_date.desc` | סדר. שלבו את `vote_average.desc` עם `vote_count.gte` כדי שמדגמים זעירים לא ידורגו ראשונים. |
| `page`                                     | 1 עד 500                                                      | עד 20 תוצאות בעמוד.                                                                        |

תיוג מילות המפתח חלקי. אם הרשימה נראית קצרה, הסירו את `with_keywords` והשאירו את מסנני הז'אנר והשפה לרשת רחבה יותר. רשימת המסננים המלאה נמצאת בעמוד [גילוי](https://amodb.dev/he/discover/), ומזהי מילות מפתח מוסברים בעמוד [מילות מפתח](https://amodb.dev/he/keywords/).

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

לסרטים משתמשים באותם שני מסננים בנקודת הקצה של סרטים. הקריאה הזו מציגה סרטי אנימציה יפניים בעלי דירוג גבוה, ו-`vote_count.gte` מסנן כותרים עם קומץ הצבעות.

```bash
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 לסדרות טלוויזיה](https://amodb.dev/he/tv-show-api/).

## כותרות ושפות

אנימה היא המקרה שבו הכותרת המקורית חשובה ביותר, ולכן שמרו את שני השדות.

| שדה                 | מה הוא מחזיק                               | שימוש                                                  |
| ------------------- | ------------------------------------------ | ------------------------------------------------------ |
| `name`              | כותרת בשפה שביקשתם                         | התווית הראשית בממשק שלכם                               |
| `original_name`     | כותרת בשפת המקור, בכתב יפני למקורות יפניים | תווית משנית, שימושית למעריצים שמכירים את הכותרת ביפנית |
| `original_language` | `ja`                                       | סינון בצד שלכם אם מערבבים מקורות                       |
| `overview`          | טקסט מתורגם, ריק כשאין תרגום               | בקשו שוב עם `language=en-US` כשהוא ריק                 |

`GET /3/tv/{series_id}/alternative_titles` מציג כותרות אחרות לפי מדינה כשהן ידועות. 14 השפות המוגשות מפורטות בעמוד [שפות](https://amodb.dev/he/languages/).

## איך זה בהשוואה

| יכולת            | גירוד אתרי מעריצים | API של מאגר אנימה בלבד           | amodb                                                   |
| ---------------- | ------------------ | -------------------------------- | ------------------------------------------------------- |
| היקף             | מה שהאתר מכסה      | אנימה בלבד, את העומק ראו במסמכים | סרטים וטלוויזיה בקטלוג אחד, אנימה נבחרת במסננים         |
| בחירת אנימה      | קטגוריות של האתר   | ראו במסמכים                      | ז'אנר 16, `with_original_language=ja`, מילת המפתח anime |
| כותרת בשפת המקור | משתנה              | ראו במסמכים                      | `original_name` ו-`original_title`                      |
| רשימות פרקים     | מנותחות מדפים      | ראו במסמכים                      | קריאת עונה עם מערך `episodes`                           |
| יפנית כשפת ממשק  | תלוי באתר          | ראו במסמכים                      | לא מוגשת, כותרות מקוריות בלבד                           |
| תנאי גישה        | התנאים של כל אתר   | מסלולים חינמיים ובתשלום משתנים   | בתשלום, תשלום מראש, בלי מסלול חינמי                     |

## תמחור

רשימת אנימה היא כמה קריאות discover, ותוצאות discover נשארות במטמון הקצה 30 דקות, ולכן 20 בקשות לדקה מספיקות לאפליקציות רבות. המסלולים הם 20, 40 או 120 בקשות לדקה עם אותם נתונים. משלמים על 1, 3, 6, 12 או 24 חודשים, עם 0, 10, 20, 30 ו-40 אחוז הנחה, וללא חידוש אוטומטי. אין מסלול חינמי. בחרו מסלול בעמוד [תמחור](https://amodb.dev/he/pricing/).

## שאלות ותשובות

### האם ל-amodb יש נקודת קצה ייעודית לאנימה?

לא. אנימה היא מסנן על נקודות הקצה הרגילות של discover: with_genres=16 עבור אנימציה ו-with_original_language=ja עבור מקור יפני. הוסיפו את מזהה מילת המפתח anime לרשימה מדויקת יותר.

### אפשר לקבל כותרות ותקצירים ביפנית?

מקורות יפניים שומרים את הכותרת ביפנית ב-original_name לסדרות וב-original_title לסרטים. יפנית אינה אחת מ-14 שפות הממשק המוגשות, ולכן name ו-overview עוקבים אחרי תגית השפה שלכם או אנגלית.

### איך מוצאים את מזהה מילת המפתח anime?

קראו ל-/3/search/keyword?query=anime וקראו את ה-id של התוצאה ששמה anime. העבירו אותו כ-with_keywords ל-discover. שמרו את המזהה אחרי החיפוש הראשון, כי חיפושי מילות מפתח נשמרים במטמון 10 דקות בלבד.

### האם ז'אנר 16 מחזיר רק אנימה?

לא. ז'אנר 16 הוא אנימציה, שכוללת גם סרטים מצוירים ממדינות אחרות. הוספת with_original_language=ja מסירה את רובם, ומילת המפתח anime מצמצמת עוד.

### עד כמה אפשר לדפדף ברשימת אנימה?

העמודים נעים בין 1 ל-500 עם עד 20 תוצאות בכל אחד, כך ששאילתה אחת מגיעה לכ-10,000 תוצאות. רשימות גדולות יותר פצלו לחלונות של first_air_date.gte ו-first_air_date.lte. תוצאות discover נשמרות במטמון 30 דקות.

## עמודים קשורים

- [API גילוי](https://amodb.dev/he/discover/): Discover API עם אותם מסננים כמו TMDB v3. הציגו סרטים וסדרות לפי ז'אנר, שחקנים, חברה, מילת מפתח, שנה, דירוג, משך וספק סטרימינג, עם מיון ודפדוף בתוצאות.
- [API מילות מפתח](https://amodb.dev/he/keywords/): API מילות מפתח עם נתיבי TMDB v3: הציגו תגיות עלילה של סרט או סדרה, חפשו מילת מפתח, הציגו את הסרטים שלה ושלבו מזהים עם with_keywords ב-discover.
- [ז'אנרים ורשימות חיפוש](https://amodb.dev/he/genres/): API ז'אנרים עם נתיבי TMDB v3: מזהי ז'אנרים של סרטים וסדרות עם שמות מתורגמים, ובנוסף רשימות של מדינות, שפות, תפקידים, דירוגי גיל וספקי סטרימינג.
- [שפות](https://amodb.dev/he/languages/): amodb מגיש כותרים, תקצירים ושמות ב-14 שפות. העבירו בפרמטר language תגית בסגנון TMDB כמו ru-RU או pt-BR; כל תגית אחרת חוזרת לאנגלית, בלי שגיאה.
- [API לסדרות טלוויזיה, עונות ופרקים](https://amodb.dev/he/tv-show-api/): API לסדרות טלוויזיה עם סטטוס, רשתות, עונות, פרקים, תאריכי שידור ו-next_episode_to_air. JSON תואם TMDB v3 ב-14 שפות, במסלולים של 20 עד 120 בקשות לדקה.
- [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות.

עודכן: 2026-10-18. Source: https://amodb.dev/he/anime-api/