קבלת מפתח API

מדריך עזר ל-API

האינדקס הזה מפרט כל נקודת קצה של amodb. בכל עמוד מופיעים הנתיב התואם ל-TMDB v3 או ל-OMDb, פרמטרי השאילתה, דוגמאות בקשה ב-curl, JavaScript, Python, PHP וב-Go ותגובת JSON אמיתית. אפשר להשתמש באותו מפתח בכולן, דרך api_key, כותרת Bearer או apikey.

סרטים

  • API פרטי סרט

    /3/movie/{movie_id}

    API פרטי סרט עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו סרט לפי מזהה, הוסיפו קרדיטים, דירוגים, מצבי רוח ופסקולים עם append_to_response, ב-14 שפות.

  • API קרדיטים

    /3/movie/{movie_id}/credits

    API קרדיטים עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו שחקנים וצוות של סרטים, סדרות, עונות ופרקים, עם credit_id, order, department ו-job ועם guest_stars בפרקים.

  • API תמונות ושרת תמונות

    /3/movie/{movie_id}/images

    API תמונות סרטים עם נתיבי TMDB v3: הציגו פוסטרים, תמונות רקע, לוגואים ותמונות סצנה לכל כותר, וטענו אותם מ-img.amodb.dev ב-10 גדלים בלי מפתח.

  • API סרטונים וטריילרים

    /3/movie/{movie_id}/videos

    API סרטונים עם נתיבי TMDB v3, כמו GET /3/movie/{movie_id}/videos: רשימת טריילרים, טיזרים, קטעים ופיצ'רטים של סרט או סדרה, ואז סינון לפי סוג ושפה בקוד שלכם.

  • API תרגומים

    /3/movie/{movie_id}/translations

    API תרגומים עם נתיבי TMDB v3: קראו בבת אחת את כל הכותרות, התקצירים והסלוגנים שנשמרו לסרט, לסדרה או לפרק, בכל השפות שלהם, עם iso_639_1 ו-english_name.

  • API מילות מפתח

    /3/movie/{movie_id}/keywords

    API מילות מפתח עם נתיבי TMDB v3: הציגו תגיות עלילה של סרט או סדרה, חפשו מילת מפתח, הציגו את הסרטים שלה ושלבו מזהים עם with_keywords ב-discover.

סדרות

  • API סדרות טלוויזיה

    /3/tv/{series_id}

    API סדרות טלוויזיה עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו סדרה לפי מזהה ב-GET /3/tv/{series_id} עם עונות, רשתות והפרק הבא, וגם סיווגי גיל וספקי צפייה.

  • API עונות ופרקים של סדרות

    /3/tv/{series_id}/season/{season_number}

    API עונות ופרקים של סדרות עם אותם נתיבים ו-JSON כמו TMDB v3. קראו עונה עם כל הפרקים שלה, או פרק אחד עם תאריך שידור, משך ותמונה מהפרק, עם crew ו-guest_stars.

אנשים

  • API פרטי אדם

    /3/person/{person_id}

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

חיפוש ורשימות

  • API חיפוש

    /3/search/movie

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

  • API גילוי

    /3/discover/movie

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

  • נקודות קצה של מגמות ורשימות

    /3/trending/{media_type}/{time_window}

    API סרטים פופולריים עם נתיבי TMDB v3: טבלאות יומיות ושבועיות, ורשימות מוקרנים עכשיו, פופולריים, מדורגים וצפויים לסרטים ולסדרות, במטמון 30 דקות.

  • ז'אנרים ורשימות חיפוש

    /3/genre/movie/list

    API ז'אנרים עם נתיבי TMDB v3: מזהי ז'אנרים של סרטים וסדרות עם שמות מתורגמים, ובנוסף רשימות של מדינות, שפות, תפקידים, דירוגי גיל וספקי סטרימינג.

  • API לאוספים

    /3/collection/{collection_id}

    API אוספי סרטים עם נתיבי TMDB v3: שלפו זיכיון ב-GET /3/collection/{collection_id} עם מערך parts, קראו את belongs_to_collection בסרט וחפשו אוספים לפי שם.

  • חברות ורשתות שידור

    /3/company/{company_id}

    חפשו חברות הפקה ורשתות טלוויזיה עם נתיבי TMDB v3. קראו שם, מדינת מקור ולוגו לפי מזהה, ואז סננו את discover באמצעות with_companies או with_networks.

  • חיפוש לפי מזהה חיצוני

    /3/find/{external_id}

    חפשו סרט, סדרה או אדם לפי מזהה IMDb, TVDB, Wikidata או Kinopoisk עם נקודת הקצה find של TMDB v3, וקראו מזהים חיצוניים ועובדות Wikidata על כל כותר.

הרחבות של amodb

  • דירוגי סרטים וסדרות

    /3/movie/{movie_id}/ratings

    API דירוגי סרטים וסדרות שמחזיר ציוני IMDb, Kinopoisk, Metacritic, Rotten Tomatoes ו-TMDB לכותר בקריאה אחת, עם value ו-votes ו-null לכל מקור שאינו ידוע.

  • מדדי מצב רוח

    /3/movie/{movie_id}/moods

    API מצב רוח בסרטים עם מדדים בסולם 0 עד 10 לכל כותר. קראו מצבי רוח של סרט או סדרה, מזגו אותם עם append_to_response=moods ובנו תגים או מסננים.

  • פסקולים

    /3/movie/{movie_id}/soundtracks

    API פסקולים שמחזיר את אלבום הפסקול של סרט או סדרה עם רשימת הרצועות שלו. קראו ל-GET /3/movie/{movie_id}/soundtracks או הוסיפו append_to_response=soundtracks.

  • זמני הקרנות בקולנוע

    /3/movie/{movie_id}/showtimes

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

בסגנון OMDb

  • נקודת קצה תואמת OMDb

    /omdb/

    נקודת קצה תואמת OMDb API בכתובת api.amodb.dev/omdb/. חפשו לפי i או t, חפשו עם s, קראו את המערך Ratings ושמרו את הלקוח שלכם בהחלפת כתובת הבסיס.