# ה-API לסרטים עם כל הדירוגים, תואם ל-TMDB ול-OMDb

> amodb הוא API בתשלום לסרטים וסדרות ששומר על הנתיבים ועל ה-JSON של TMDB v3 ושל OMDb, ולכן הקוד שלכם עובד אחרי החלפת כתובת הבסיס. מפתח אחד מוסיף דירוגי IMDb, Rotten Tomatoes, Metacritic ו-Kinopoisk, מדדי מצב רוח ופסקולים, ושימוש מסחרי כלול בכל מסלול בתשלום מראש.

## למה לשלם עבור API לסרטים אם TMDB חינמי?

TMDB חינמי עד שהאפליקציה שלכם מרוויחה את הדולר הראשון. אחרי זה TMDB דורש את המסלול המסחרי שלו, $149 לחודש לחברות עם הכנסות מתחת ל-$1M. ל-TMDB גם אין ציוני IMDb, Rotten Tomatoes או Metacritic, וה-API השני הנפוץ, OMDb, מורשה לשימוש לא מסחרי. amodb מציע את שני הפורמטים במפתח אחד, עם שימוש מסחרי כלול, החל מ-‏3.11 ‏$ לחודש.

| יכולת                                     | TMDB                          | OMDb             | amodb                       |
| ----------------------------------------- | ----------------------------- | ---------------- | --------------------------- |
| המחיר כשהאפליקציה שלכם מרוויחה            | $149 לחודש בהכנסות מתחת ל-$1M | תנאים לא מסחריים | החל מ-‏3.11 ‏$ לחודש        |
| נתיבים ו-JSON של TMDB v3                  | כן                            | לא               | כן                          |
| פרמטרים ושדות של OMDb                     | לא                            | כן               | כן                          |
| דירוגי IMDb, Rotten Tomatoes ו-Metacritic | לא, רק ציון TMDB              | כן               | כן, ובנוסף Kinopoisk ו-TMDB |
| מדדי מצב רוח, פסקולים וזמני הקרנה         | לא                            | לא               | כן                          |
| אין חובה להציג לוגו או הודעה במסכים שלכם  | לא, חובה להציג לוגו והודעה    | לא צוין          | כן                          |
| מפתח אחד לשני הפורמטים                    | לא                            | לא               | כן                          |

מקורות: [תנאי השימוש ב-API של TMDB](https://www.themoviedb.org/api-terms-of-use), תשובות של צוות TMDB על [תמחור מסחרי](https://www.themoviedb.org/talk/69cbf4f91b914f0e9542a772) ועל [מתי אפליקציה נחשבת מסחרית](https://www.themoviedb.org/talk/6ac5579ae24d7a00344571d5), ו[הדף המשפטי של OMDb](https://www.omdbapi.com/legal.htm), נקראו באוקטובר 2026.

## מחליפים את כתובת הבסיס, והקוד נשאר

amodb עונה באותם נתיבים כמו TMDB v3. בקשה לסרט 550 מחזירה את אותם שדות JSON שהלקוח שלכם כבר מפענח: `id`, `title`, `genres`, `release_date`, `poster_path` ועוד.

שלחו את המפתח כ-`api_key` בשאילתה או בכותרת `Authorization: Bearer`. שתי הדרכים עובדות בכל נקודת קצה.

```bash
curl "https://api.amodb.dev/3/movie/550?language=en-US" \
  -H "Authorization: Bearer $AMODB_KEY"
```

```js
const res = await fetch("https://api.amodb.dev/3/movie/550?language=en-US", {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

```python
import os
import requests

res = requests.get(
    "https://api.amodb.dev/3/movie/550",
    params={"language": "en-US"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
movie = res.json()
print(movie["title"], movie["release_date"])
```

```json
{
  "id": 550,
  "imdb_id": "tt0137523",
  "title": "Fight Club",
  "release_date": "1999-10-15",
  "runtime": 139,
  "genres": [{ "id": 18, "name": "Drama" }],
  "vote_average": 8.4,
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}
```

## מפתח אחד לקריאות בסגנון OMDb

נקודת הקצה התואמת ל-OMDb נמצאת בכתובת `https://api.amodb.dev/omdb/`. היא מקבלת `i`, `t`, `s`, `type`, `y`, `plot` ו-`page`, ומחזירה `Title`, `Year`, `imdbRating`, `Ratings` ואת שאר שדות OMDb.

השדה `Poster` מצביע אל `img.amodb.dev`, ולכן הפוסטרים נטענים מאותו שירות. השגיאות שומרות על המבנה של OMDb: `{"Response":"False","Error":"..."}`.

```bash
curl "https://api.amodb.dev/omdb/?i=tt0137523&plot=short&apikey=$AMODB_KEY"
```

```js
const url = new URL("https://api.amodb.dev/omdb/");
url.searchParams.set("t", "Fight Club");
url.searchParams.set("y", "1999");
url.searchParams.set("apikey", process.env.AMODB_KEY);

const film = await (await fetch(url)).json();
console.log(film.Title, film.imdbRating);
```

```python
import os
import requests

film = requests.get(
    "https://api.amodb.dev/omdb/",
    params={"i": "tt0137523", "apikey": os.environ["AMODB_KEY"]},
    timeout=10,
).json()
print(film["Title"], film["imdbRating"])
```

```json
{
  "Title": "Fight Club",
  "Year": "1999",
  "Runtime": "139 min",
  "Director": "David Fincher",
  "imdbRating": "8.8",
  "imdbID": "tt0137523",
  "Poster": "https://img.amodb.dev/t/p/w300/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
  "Response": "True"
}
```

## נתונים ש-TMDB v3 לא מחזיר

כל מפתח יכול לקרוא להרחבות של amodb באותה כתובת בסיס. מוסיפים אותן עם `append_to_response` או קוראים להן בנפרד.

- **מדדי מצב רוח**: פחד, הומור, עצב, אלימות ועוד, כל אחד בסולם של 0 עד 10, בקריאה נוספת אחת.
- **דירוגים בקריאה אחת**: ציוני IMDb ו-TMDB ועוד שלושה מקורות, עם מספר הקולות, מנקודת קצה אחת.
- **מגבלת קצב שאפשר לראות**: כל תגובה מראה כמה בקשות נשארו בדקה הזו.
- **מזהה אחד, 14 שפות**: אותו סרט בכל שפה ש-amodb מגיש. תגיות לא מוכרות חוזרות לאנגלית.
- **כל גדלי התמונות של TMDB**: מתמונות ממוזערות בגודל w92 ועד הקבצים המקוריים ב-img.amodb.dev. בלי מפתח.
- **חיפוש לפי כל מזהה חיצוני**: שלחו מזהה IMDb או מזהה חיצוני אחר וקבלו בחזרה את הרשומה של TMDB.
- **זמני הקרנה בקולנוע**: זמני הקרנה לפי מדינה לכותרים שמוקרנים בקולנוע, כשהם ידועים.
- **פסקולים**: השירים ששימשו בסרט או בסדרה, באותה כתובת בסיס.

## כותרים ותקצירים ב-14 שפות

העבירו ב-`language` תגית בסגנון TMDB, כמו `ru-RU` או `pt-BR`. amodb מגיש 14 שפות בסיס וחוזר לאנגלית בכל תגית אחרת, ולכן בקשה אף פעם לא נכשלת בגלל שפה.

| Code | Language   | Native name | Example tag |
| ---- | ---------- | ----------- | ----------- |
| `en` | English    | English     | `en-US`     |
| `ru` | Russian    | Русский     | `ru-RU`     |
| `uk` | Ukrainian  | Українська  | `uk-UA`     |
| `be` | Belarusian | Беларуская  | `be-BY`     |
| `zh` | Chinese    | 中文          | `zh-CN`     |
| `pt` | Portuguese | Português   | `pt-BR`     |
| `bg` | Bulgarian  | Български   | `bg-BG`     |
| `he` | Hebrew     | עברית       | `he-IL`     |
| `cs` | Czech      | Čeština     | `cs-CZ`     |
| `ro` | Romanian   | Română      | `ro-RO`     |
| `fr` | French     | Français    | `fr-FR`     |
| `pl` | Polish     | Polski      | `pl-PL`     |
| `it` | Italian    | Italiano    | `it-IT`     |
| `es` | Spanish    | Español     | `es-ES`     |

## נבנה לפרויקטים אישיים ומסחריים

פרויקט סוף שבוע ומוצר בתשלום קוראים לאותו API, מקבלים את אותם נתונים וחלים עליהם אותם [תנאי שימוש](https://amodb.dev/he/terms/). זה מה שצוותים בונים איתו.

- **אפליקציות סטרימינג ורשימות צפייה:** פוסטרים, טריילרים, עונות ופרקים, ועוד חמישה דירוגים למיון ולסינון.
- **בוטים ל-Telegram ול-Discord:** חיפוש בסגנון OMDb לפי שם או מזהה IMDb מחזיר תשובה מוכנה בקריאה אחת.
- **שרתי מדיה ותוספים:** כלים לאיסוף מטא-דאטה שכבר עובדים עם TMDB v3 שומרים על הלקוח שלהם ומקבלים גם ציוני IMDb ו-Rotten Tomatoes.
- **אתרי סרטים ובלוגים:** כותרים ותקצירים ב-14 שפות, כדי שלכל שוק יהיה עמוד משלו.
- **מנועי המלצות:** מדדי מצב רוח מדרגים פחד, הומור, אלימות ועוד בסולם של 0 עד 10, אותות שז'אנרים לבדם מפספסים.
- **סוכני AI וצ'אטבוטים:** עונים על "מה לראות הערב" עם דירוגים אמיתיים, מצבי רוח, שחקנים וזמני הקרנה.

## המסלולים נבדלים בבקשות לדקה

בכל מסלול מקבלים את אותם הנתונים: את נקודות הקצה של TMDB ושל OMDb, את כל 14 השפות, את התמונות ואת ההרחבות. ב-Pro+ מקבלים גם את `/3/all`: הכול על סרט, סדרה או אדם בבקשה אחת. משלמים פעם אחת עבור 1, 3, 6, 12 או 24 חודשים, ותקופה ארוכה יותר עולה פחות לחודש. אין מסלול חינמי ואין חידוש אוטומטי.

| תכונה               | Lite      | Pro       | Pro+       |
| ------------------- | --------- | --------- | ---------- |
| בקשות לדקה          | 20        | 40        | 120        |
| בקשות ביום בקצב מלא | 28,800    | 57,600    | 172,800    |
| מחיר עבור 1 חודש    | ‏5.19 ‏$  | ‏6.19 ‏$  | ‏7.19 ‏$   |
| מחיר עבור 3 חודשים  | ‏14.01 ‏$ | ‏16.71 ‏$ | ‏19.41 ‏$  |
| מחיר עבור 6 חודשים  | ‏24.91 ‏$ | ‏29.71 ‏$ | ‏34.51 ‏$  |
| מחיר עבור 12 חודשים | ‏43.60 ‏$ | ‏52.00 ‏$ | ‏60.40 ‏$  |
| מחיר עבור 24 חודשים | ‏74.74 ‏$ | ‏89.14 ‏$ | ‏103.54 ‏$ |

## בנוי לתעבורת ייצור

רשימות פופולריות נשמרות במטמון ל-30 דקות, פרטים ל-6 שעות ו-`configuration` ל-24 שעות.
כל תגובה נושאת את `X-RateLimit-Limit`, את `X-RateLimit-Remaining` ואת `X-RateLimit-Reset`. תגובת 429 מוסיפה `Retry-After`.
שגיאות מחזירות `success`, `status_code` ו-`status_message`, ולכן הטיפול הקיים בשגיאות ממשיך לעבוד.
פוסטרים ותמונות רקע נטענים מ-`img.amodb.dev/t/p/{size}/{file}` בכל הגדלים של TMDB ונשמרים במטמון ל-30 ימים.

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

### האם ה-API של TMDB חינמי לשימוש מסחרי?

לא. מפתח TMDB חינמי כל עוד הפרויקט שלכם לא מרוויח כסף. צוות TMDB מציין שכל הכנסה מפרסומות, מרכישות באפליקציה, מתרומות או ממנויים הופכת אפליקציה למסחרית, והמסלול המסחרי עולה $149 לחודש לחברות עם הכנסות מתחת ל-$1M. amodb כולל שימוש מסחרי בכל מסלול.

### כמה עולה ה-API של TMDB?

הוא חינמי לשימוש לא מסחרי. באפליקציה מסחרית צוות TMDB מציין $149 לחודש כשההכנסה השנתית מתחת ל-$1M, ומחיר מותאם אישית מעבר לכך. מסלולי amodb עולים כמה דולרים בחודש ונבדלים בעיקר בבקשות לדקה.

### למה לשלם עבור amodb אם ה-API של TMDB חינמי?

כי אפליקציה שמרוויחה כסף אינה חינמית ב-TMDB. amodb עולה שבריר מהמסלול המסחרי של TMDB, $149, לא דורש לוגו על המסכים שלכם, ומחזיר דירוגי IMDb, Rotten Tomatoes, Metacritic ו-Kinopoisk באותה תגובה. מפתח אחד משרת גם את הפורמט של TMDB v3 וגם את זה של OMDb, כך שמפעילים API אחד במקום שניים.

### האם OMDb חינמי לשימוש מסחרי?

הדף המשפטי של OMDb מתאר את השירות לשימוש אישי ולא מסחרי, ומעניק רישיון לתוכן שלו לפי CC BY-NC 4.0. amodb עונה על אותם פרמטרים של OMDb עם אותם שמות שדות, ושימוש מסחרי כלול.

### האם צריך לשנות את קוד הלקוח שלי של TMDB?

לא. כוונו את כתובת הבסיס אל https://api.amodb.dev/3 ושלחו את מפתח amodb כ-api_key או כאסימון Bearer. הנתיבים, פרמטרי השאילתה ושדות ה-JSON נשארים כמו ב-TMDB v3.

### האם אותו מפתח עובד בקריאות בסגנון OMDb?

כן. שלחו אותו כ-apikey אל https://api.amodb.dev/omdb/. הפרמטרים i, t, s, type, y, plot ו-page עובדים כמו ב-OMDb, והתגובה משתמשת בשמות השדות של OMDb.

### האם יש מסלול חינמי או תקופת ניסיון?

לא. amodb פועל בתשלום מראש בלבד. בוחרים מסלול ותקופה, משלמים פעם אחת בכרטיס אשראי, ב-Apple Pay, ב-Google Pay, בקריפטו או ב-Patreon, והמפתח פועל עד סוף התקופה. אין חידוש אוטומטי.

### במה נבדלים המסלולים?

קצב הבקשות: 20, 40 או 120 בקשות לדקה. בכל מסלול מקבלים את אותם הנתונים, את כל 14 השפות, את התמונות, את הדירוגים ואת שאר ההרחבות של amodb. ב-Pro+ מקבלים גם את /3/all: הכול על סרט, סדרה או אדם בבקשה אחת.

### אילו שפות נתמכות?

אנגלית, רוסית, אוקראינית, בלארוסית, סינית, פורטוגזית, בולגרית, עברית, צ'כית, רומנית, צרפתית, פולנית, איטלקית וספרדית. העבירו תגית בסגנון TMDB כמו ru-RU; כל שפה אחרת חוזרת לאנגלית.

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

- [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות.
- [תמחור](https://amodb.dev/he/pricing/): המסלולים של amodb נבדלים רק בבקשות לדקה: 20, 40 או 120. כל מסלול כולל את כל הנתונים התואמים ל-TMDB v3 ול-OMDb. תשלום מראש, בלי חידוש ובלי ניסיון.
- [amodb מול TMDB](https://amodb.dev/he/amodb-vs-tmdb/): השוואה ישירה בין amodb ל-TMDB: התאמת נקודות קצה ו-JSON, הנתיבים ש-amodb לא מציע, תנאים חינמיים מול בתשלום, 14 שפות, חמש הרחבות ומגבלות קצב לכל מפתח.
- [חלופה ל-TMDB API](https://amodb.dev/he/tmdb-api-alternative/): מחפשים חלופה ל-TMDB API? בדקו תנאים, מגבלות, שפות ודירוגים, ועברו ל-API בתשלום ששומר את רוב נתיבי הקריאה וה-JSON של TMDB v3. ראו את הפערים לפני המעבר.

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