# חלופה ל-TMDB API

> כדאי לחפש חלופה ל-TMDB API כשרוצים הסכם בתשלום, מגבלת בקשות שאפשר לתכנן סביבה, או יותר נתונים בכל תגובה. amodb מדבר בפרוטוקול TMDB v3 לקריאה, ולכן מחליפים את כתובת הבסיס ואת המפתח. כתיבה וכמה נתיבים אינם קיימים. הישארו ב-TMDB אם התנאים החינמיים שלו מתאימים.

## איזה API לבחור

TMDB מציע API חינמי לשימוש מתאים לפי התנאים שלו, עם מפתחות API v3 ואסימוני v4. קראו את התנאים האלה לשימוש מסחרי ולייחוס לפני ההשקה. בחרו בחלופה כשאתם רוצים הסכם בתשלום, מגבלה שאפשר לתכנן סביבה, או יותר נתונים בכל תגובה. amodb הוא API עצמאי שמדבר בפרוטוקול TMDB v3 לקריאה, ולכן מעבר פירושו כתובת בסיס חדשה ומפתח חדש. הוא לקריאה בלבד, וכמה נתיבים של TMDB אינם קיימים, כפי שמופיע בהמשך.

הישארו ב-TMDB אם התנאים החינמיים מתאימים לפרויקט שלכם ושום דבר בסעיף הבא לא חל עליכם.

## סימנים לכך שאתם צריכים חלופה

חמש בדיקות עוזרות להחליט. הריצו אותן מול התעבורה והחוזה שלכם, לא מול רשימת תכונות.

| סימן          | מה לבדוק                                                          | התשובה של amodb                                                                          |
| ------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| תנאים מסחריים | קראו את התנאים של ה-API שבו אתם משתמשים היום לשימוש מסחרי ולייחוס | מסלולים בתשלום, תשלום מראש, בלי חידוש אוטומטי                                            |
| תעבורת שיא    | ספרו בקשות בדקה העמוסה ביותר שלכם                                 | מגבלה קבועה של 20, 40 או 120 בקשות לדקה לכל מפתח                                         |
| נתונים למסך   | רשמו את הקריאות הנוספות מאחורי עמוד כותר אחד                      | `append_to_response` מקבל גם `ratings`, `moods`, `soundtracks`, `wikidata` ו-`showtimes` |
| שפת ממשק      | בדקו כל שפה שאתם משיקים                                           | 14 שפות, כל השאר חוזרות ל-`en`                                                           |
| עלות יציאה    | ספרו את שורות הקוד ששמות ספק                                      | אותם נתיבים ו-JSON בנקודות הקצה שמוגשות, ולכן גם עזיבה היא החלפת כתובת בסיס              |

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

## השוואת תכונות

| תכונה       | TMDB                                                 | amodb                                                                      |
| ----------- | ---------------------------------------------------- | -------------------------------------------------------------------------- |
| מודל תמחור  | API חינמי לשימוש מתאים לפי התנאים שלו                | תקופות בתשלום מראש של 1, 3, 6, 12 או 24 חודשים                             |
| מסלול חינמי | כן, לשימוש מתאים                                     | אין, וגם אין תקופת ניסיון                                                  |
| אימות       | מפתח v3 ב-`api_key`, או אסימון v4 כ-Bearer           | `api_key` או Bearer, מפתח של 32 תווים הקסדצימליים                          |
| פורמט תגובה | JSON                                                 | JSON במבנה של TMDB v3                                                      |
| שפות        | ראו במסמכים שלהם                                     | 14 שפות ממשק                                                               |
| סרטים       | כן                                                   | כן                                                                         |
| סדרות       | כן                                                   | כן, עם עונות ופרקים                                                        |
| אנשים       | כן                                                   | כן                                                                         |
| תמונות      | כן, ממארח התמונות שלו                                | `img.amodb.dev`, אותם מזהי גודל, בלי מפתח                                  |
| דירוגים     | ציון המשתמשים של TMDB, מקורות אחרים ראו במסמכים שלהם | ציון TMDB ובנוסף IMDb, Kinopoisk, Metacritic ו-Rotten Tomatoes כשהם ידועים |
| שיטות כתיבה | שיטות חשבון, רשימות ודירוג                           | לא קיים, הן מחזירות 405                                                    |
| מגבלת קצב   | ראו במסמכים שלהם                                     | 20, 40 או 120 לדקה לכל מפתח                                                |
| שימוש מסחרי | את התנאים לשימוש מסחרי ולייחוס ראו אצלם              | נמכר כ-API בתשלום, ראו [תמחור](https://amodb.dev/he/pricing/)              |
| תאימות      | מגדיר את פרוטוקול v3                                 | רוב נתיבי הקריאה של v3, ובנוסף OMDb                                        |

## במה amodb שונה

- **מגבלות שאפשר לקרוא.** כל תגובה עם מפתח נושאת `X-RateLimit-Limit`, `X-RateLimit-Remaining` ו-`X-RateLimit-Reset` בשניות. תגובת 429 מוסיפה `Retry-After`. המספרים מוסברים בעמוד [מגבלות קצב](https://amodb.dev/he/rate-limits/).
- **בלוקים נוספים בקריאה אחת.** דירוגים מחמישה מקורות, מדדי מצב רוח, פסקולים, עובדות מ-Wikidata וזמני הקרנה בקולנוע מגיעים דרך `append_to_response`, ולכן עמוד כותר אחד יכול להסתפק בבקשה אחת.
- **עוד מקורות של מזהים חיצוניים.** `/3/find` פותר את `imdb_id`, `tvdb_id`, `wikidata_id` ו-`kinopoisk_id`, וגם את `facebook_id`, `twitter_id` ו-`instagram_id`. ראו [חיפוש לפי מזהה חיצוני](https://amodb.dev/he/find-by-external-id/).
- **OMDb על אותו מפתח.** `https://api.amodb.dev/omdb/` עונה לקריאות בסגנון OMDb עם הפרמטר `apikey`, מה שעוזר כששתי מערכות שלכם משתמשות בפרוטוקולים שונים.
- **זמני מטמון ידועים.** פרטים וקרדיטים נשארים 6 שעות בקצה, טרנדים וגילוי 30 דקות, חיפוש 10 דקות, הגדרות 24 שעות ותמונות 30 יום.

## מתי TMDB מתאים יותר

- **פרויקטים חינמיים.** אם השימוש שלכם עומד בתנאים החינמיים, TMDB לא עולה כלום, ו-amodb לא יכול להתחרות בזה.
- **שיטות כתיבה של משתמשים.** TMDB מציע שיטות כתיבה לחשבון, להתחברות, לדירוג ולרשימות. amodb עונה להן 405 עם status_code 37, ולכן אפליקציה שמאפשרת למשתמשים להתחבר ולדרג כותרים צריכה להשאיר את TMDB לחלק הזה.
- **פידים של שינויים.** TMDB מציג את המזהים שהשתנו. ל-amodb אין פיד כזה, ולכן מרעננים לפי לוח הזמנים שלכם.
- **שפות מעבר ל-14.** amodb לא מגיש טקסט ממשק בגרמנית, ביפנית או בקוריאנית וחוזר לאנגלית. כותרות מקוריות עדיין מגיעות ב-`original_title` וב-`original_name`. לשפות אחרות ב-TMDB ראו במסמכים שלהם.
- **תנאים שכבר אישרתם.** אם הבדיקה המשפטית כבר נעשתה עבור TMDB, מעבר עולה לכם בבדיקה נוספת.

## מה amodb לא מציע

בדקו את הקוד שלכם מול הרשימה הזו לפני המעבר. הטבלה המלאה נמצאת בעמוד [amodb מול TMDB](https://amodb.dev/he/amodb-vs-tmdb/).

| קריאה ב-TMDB                                                          | התשובה של amodb        |
| --------------------------------------------------------------------- | ---------------------- |
| כתיבות של חשבון, התחברות, דירוג ורשימות                               | 405, `status_code` 37  |
| שינויים, קרדיטים מצטברים, שליפת קרדיט או ביקורת, תוכן של קבוצות פרקים | 404, `status_code` 34  |
| תרגומי אנשים, תמונות ותרגומים של אוספים, חברות ורשתות                 | 404, `status_code` 34  |
| רשימת ביקורות של סרט או סדרה                                          | 200, ריקה ברוב הכותרים |
| תמונות, סרטונים ותרגומים של עונה                                      | 200, ריקים             |
| מזהים חיצוניים של עונות ופרקים                                        | 200, כולם null         |

שתי התנהגויות שקטות. שם של `append_to_response` ש-amodb לא מכיר, כמו `aggregate_credits`, מתעלמים ממנו בלי שגיאה. גם הפרמטר `include_adult` מתעלמים ממנו, כי כותרים ואנשים למבוגרים לא מוגשים לעולם.

## מעבר ל-amodb

1. בחרו מסלול בעמוד [תמחור](https://amodb.dev/he/pricing/) וצרו מפתח בלוח הבקרה של החשבון.
2. החליפו את כתובת הבסיס ואת המפתח במקום אחד, כמו להלן.
3. קראו את `images.secure_base_url` מ-`/3/configuration` כדי שקישורי התמונות ישתמשו ב-`img.amodb.dev`.
4. הסירו קריאות לשיטות כתיבה ולנתיבים שבטבלה למעלה.
5. טפלו ב-429 בהמתנה של `Retry-After` שניות.

```js
const config = {
  // before: baseUrl held your current TMDB v3 base URL
  baseUrl: 'https://api.amodb.dev/3',
  apiKey: process.env.AMODB_KEY,
};

const res = await fetch(`${config.baseUrl}/movie/550?language=en-US`, {
  headers: { Authorization: `Bearer ${config.apiKey}` },
});
if (!res.ok) throw new Error(`request failed with status ${res.status}`);
const movie = await res.json();
console.log(movie.title, movie.release_date);
```

הריצו את הבדיקות הקיימות שלכם מול שתי כתובות הבסיס לפני המעבר. מבנה משותף לא מבטיח ערכים זהים, ולכן השוו מדגם מהכותרים שלכם. המדריך המלא נמצא ב[מדריך למתחילים](https://amodb.dev/he/quickstart/), וטבלת השוואה נמצאת בעמוד [amodb מול TMDB](https://amodb.dev/he/amodb-vs-tmdb/).

### טיפול בשגיאות עובר כמו שהוא

קריאות שנכשלות מחזירות את גוף התגובה של TMDB `{"success": false, "status_code": N, "status_message": "..."}`, ולכן קוד שמסתעף לפי `status_code` לא צריך שכתוב.

| HTTP | status_code | סיבה אופיינית                           |
| ---- | ----------- | --------------------------------------- |
| 401  | 7           | המפתח חסר או הוקלד בטעות                |
| 401  | 10          | המפתח הושעה                             |
| 402  | 36          | תקופת התשלום מראש הסתיימה               |
| 404  | 34          | המזהה לא נמצא, או נתיב ש-amodb לא מציע  |
| 405  | 37          | שיטת כתיבה שהקוד שלכם עדיין קורא לה     |
| 429  | 25          | יותר בקשות ממה שהמסלול מאפשר ב-60 שניות |

התייחסו ל-402 כאות לחידוש ידני, כי שום דבר לא מתחדש אוטומטית. הרשימה המלאה נמצאת בעמוד [שגיאות](https://amodb.dev/he/errors/).

## תמחור

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

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

### האם amodb הוא תחליף ישיר ל-TMDB API?

ברוב נקודות הקצה לקריאה, כן. נתיבים, פרמטרי שאילתה ושדות JSON עוקבים אחרי TMDB v3, ואימות גם ב-api_key וגם ב-Bearer עובד. שיטות כתיבה מחזירות 405 עם status_code 37. פידים של שינויים, קרדיטים מצטברים, שליפת קרדיט או ביקורת בודדים וכמה נתיבים אחרים מחזירים 404 עם status_code 34.

### האם כתובות התמונות שלי מ-TMDB ימשיכו לעבוד?

מבנה הנתיב ומזהי הגודל נשארים זהים, אבל המארח הוא img.amodb.dev ואין צורך במפתח. קראו את images.secure_base_url מנקודת הקצה של ההגדרות במקום לקבוע מארח בקוד, וקוד התמונות שלכם לא צריך שום שינוי אחר.

### האם amodb מקבל כותרת Bearer כמו TMDB?

כן. שלחו Authorization: Bearer עם מפתח amodb שלכם, או העבירו את פרמטר השאילתה api_key. המפתח הוא 32 תווים הקסדצימליים באותיות קטנות, באותה צורה כמו מפתח TMDB v3.

### איך העלות מתייחסת ל-API החינמי של TMDB?

TMDB מציע API חינמי לשימוש מתאים לפי התנאים שלו. ל-amodb אין מסלול חינמי ואין תקופת ניסיון. משלמים מראש על 1 עד 24 חודשים באחד משלושה מסלולים, ועמוד התמחור מציג את הסכומים הנוכחיים.

### לאיזו מגבלה לתכנן?

התאימו אותה לדקה העמוסה ביותר שלכם. המסלולים מאפשרים 20, 40 או 120 בקשות לדקה לכל מפתח בחלון נע של 60 שניות, וכל מסלול מחזיר את כל הנתונים. כותרות התגובה מציגות כמה בקשות נותרו.

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

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

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