# API לשחקנים > ה-API לשחקנים הוא משפחת האנשים של TMDB v3 בכתובת api.amodb.dev/3. שולפים אדם עם GET /3/person/{person_id}, מוסיפים combined_credits לפילמוגרפיה המלאה ו-images לתמונות פרופיל. רשימה פופולרית, חיפוש לפי שם וחיפוש לפי מזהה IMDb משתמשים באותו מפתח ובאותו מבנה JSON. ביוגרפיות זמינות ב-14 שפות דרך הפרמטר language. ## חיפוש שחקן והפילמוגרפיה שלו `GET /3/person/{person_id}` מחזיר ביוגרפיה, נתוני לידה ונתיב לתמונת פרופיל של אדם אחד. הוסיפו `append_to_response=combined_credits` והתגובה עצמה תכלול גם כל תפקיד בסרטים ובטלוויזיה. המזהים הם המזהים המספריים של אנשים ב-TMDB, למשל `31` עבור Tom Hanks. מקבלים רשומת אדם, פילמוגרפיה של שחקנים וצוות, תמונות פרופיל, ורשימות לגילוי. שחקנים, במאים ותסריטאים נמצאים כולם באותן נקודות קצה ונבדלים לפי `known_for_department`. ## אילו נתונים מקבלים | נקודת קצה | מה מוחזר | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `GET /3/person/{person_id}` | `name`, `biography`, `birthday`, `deathday`, `place_of_birth`, `known_for_department`, `profile_path`, `imdb_id` | | `GET /3/person/{person_id}/movie_credits` | תפקידי סרטים ב-`cast` ותפקידי צוות ב-`crew` | | `GET /3/person/{person_id}/tv_credits` | אותו דבר לסדרות | | `GET /3/person/{person_id}/combined_credits` | סרטים וטלוויזיה ברשימה אחת, מסומנים לפי `media_type` | | `GET /3/person/{person_id}/images` | מערך `profiles` של תמונות | | `GET /3/person/popular` | רשימה מדורגת של אנשים פופולריים | | `GET /3/search/person` | אנשים שמתאימים ל-`query` | ## מתחילים בשלושה שלבים 1. בחרו מסלול בעמוד [תמחור](https://amodb.dev/he/pricing/). כל המסלולים מחזירים את אותם נתונים ונבדלים רק בבקשות לדקה. 2. צרו מפתח בלוח הבקרה של החשבון. 3. שלחו `GET /3/person/31` עם `Authorization: Bearer YOUR_API_KEY`, או השתמשו ב-`api_key` במחרוזת השאילתה. ## בקשה לדוגמה הקריאה הזו שולפת את Tom Hanks עם הקרדיטים המשולבים שלו. דוגמת ה-Python שומרת תפקידים בסרטים שיש להם תאריך יציאה, ממיינת מהחדש לישן, מדפיסה חמישה ואת כתובת התמונה. ```bash curl -s "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \ -H "Authorization: Bearer $AMODB_KEY" ``` ```python import os import requests BASE = "https://api.amodb.dev/3" HEADERS = {"Authorization": f"Bearer {os.environ['AMODB_KEY']}"} r = requests.get( f"{BASE}/person/31", params={"language": "en-US", "append_to_response": "combined_credits"}, headers=HEADERS, timeout=10, ) r.raise_for_status() person = r.json() movies = [ c for c in person["combined_credits"]["cast"] if c["media_type"] == "movie" and c.get("release_date") ] movies.sort(key=lambda c: c["release_date"], reverse=True) print(person["name"], person["birthday"], person["known_for_department"]) if person.get("profile_path"): print("Photo:", "https://img.amodb.dev/t/p/w342" + person["profile_path"]) for c in movies[:5]: print(c["release_date"][:4], c["title"], "as", c.get("character") or "n/a") ``` התגובה מקוצרת עבור `language=en-US`. השדה `combined_credits` קוצר ל-2 שורות שחקנים ושורת צוות אחת, והביוגרפיה קוצרה. ```json { "adult": false, "also_known_as": [ "Thomas Jeffrey Hanks" ], "biography": "Thomas Jeffrey Hanks (born July 9, 1956) is an American actor and filmmaker. Known for...", "birthday": "1956-07-09", "deathday": null, "gender": 2, "homepage": null, "id": 31, "imdb_id": "nm0000158", "known_for_department": "Acting", "name": "Tom Hanks", "place_of_birth": "Concord, California, USA", "popularity": 12.98, "profile_path": "/oFvZoKI6lvU03n4YoNGAll9rkas.jpg", "combined_credits": { "cast": [ { "adult": false, "backdrop_path": "/owUcU7WcM42uPXIVJHglDQceY5R.jpg", "genre_ids": [ 12, 16, 35 ], "id": 1084244, "original_language": "en", "original_title": "Toy Story 5", "overview": "", "popularity": 158.5027, "poster_path": "/sfQtVlIHljToOwYjhe21KPGzZWK.jpg", "release_date": "2026-06-17", "title": "Toy Story 5", "video": false, "vote_average": 8.285, "vote_count": 2649, "media_type": "movie", "credit_id": "65edd5772790bf01634423c9", "character": "Woody (voice)", "order": 0 }, { "adult": false, "backdrop_path": "/1dvOCqKgBcXvfqzVPmAAM5Rv4PP.jpg", "genre_ids": [ 16, 35, 10751 ], "id": 863, "original_language": "en", "original_title": "Toy Story 2", "overview": "", "popularity": 49.6885, "poster_path": "/4rbcp3ng8n1MKHjpeqW0L7Fnpzz.jpg", "release_date": "1999-10-30", "title": "Toy Story 2", "video": false, "vote_average": 7.6, "vote_count": 15484, "media_type": "movie", "credit_id": "5ac0152ec3a368443f034084", "character": "Woody (voice)", "order": 0 } ], "crew": [ { "adult": false, "backdrop_path": "/23GjGDQdMHW5C2UYwSV00fE3FNi.jpg", "first_air_date": "2001-09-09", "genre_ids": [ 18, 10768 ], "id": 4613, "name": "Band of Brothers", "origin_country": [], "original_language": "en", "original_name": "Band of Brothers", "overview": "", "popularity": 63.5427, "poster_path": "/pGzV187ogXzgJrvPRy2YPi29ofH.jpg", "vote_average": 8.608, "vote_count": 4424, "media_type": "tv", "credit_id": "5257765d760ee36aaa522862", "department": "Production", "job": "Executive Producer" } ] } } ``` ## בניית פילמוגרפיה אדם יכול להופיע ב-`cast` וגם ב-`crew` של אותו כותר, למשל שחקן שגם מביים. התייחסו לשני המערכים כאל רשימות נפרדות ומזגו אותם בתצוגה שלכם. שורות של סרטים ושל סדרות משתמשות בשמות שדות שונים, ולכן קראו את הנכון. | שדה | שורות | משמעות | | ---------------------------------- | -------------------------- | ----------------------------- | | `media_type` | קרדיטים משולבים | `movie` או `tv` | | `title` או `name` | שורות סרטים או שורות סדרות | כותרת להצגה | | `release_date` או `first_air_date` | שורות סרטים או שורות סדרות | מפתח מיון, עשוי להיות ריק | | `character` | שחקנים | שם התפקיד | | `job`, `department` | צוות | למשל `Director` ב-`Directing` | | `credit_id` | שניהם | מזהה שורת הקרדיט | מיינו לפי תאריך, שימו שורות בלי תאריך בסוף, והסירו כפילויות לפי הצמד `id` ו-`media_type`. שורות שחקנים בסדרות נושאות `episode_count`, אבל amodb מחזיר שם `0`, ולכן אל תשתמשו בו כדי לספור פרקים. amodb לא מציע `GET /3/credit/{credit_id}` או `aggregate_credits`. פרטי שדות השחקנים והצוות נמצאים בעמוד [קרדיטים](https://amodb.dev/he/credits/). ## תמונות פרופיל `profile_path` מתחבר למארח התמונות: `https://img.amodb.dev/t/p/{size}{profile_path}`. השתמשו ב-`w185` לתמונות ממוזערות ברשימות, ב-`h632` לעמוד פרופיל וב-`original` להורדות. תמונות לא דורשות מפתח והן נשמרות במטמון 30 יום. ליותר מתמונה אחת קראו ל-`GET /3/person/{person_id}/images`. המערך `profiles` כולל `file_path`, `width`, `height`, `aspect_ratio` ו-`vote_average`, כך שאפשר לבחור את הדיוקן בעל הדירוג הגבוה ביותר. טבלאות גדלים ו-`srcset` נמצאות בעמוד [תמונות](https://amodb.dev/he/images-api/). ## אנשים פופולריים, חיפוש וחיפוש לפי מזהה - `GET /3/person/popular?page=1` מחזיר רשימה מדורגת. העמודים נעים בין 1 ל-500, והרשימה נשמרת במטמון 30 דקות. - `GET /3/search/person?query=tom+hanks` מתאים לפי שם. נשמר במטמון 10 דקות. - `GET /3/find/{external_id}?external_source=imdb_id` ממפה מזהה שם של IMDb לאדם. קראו את `person_results` בתגובה. ראו [חיפוש לפי מזהה חיצוני](https://amodb.dev/he/find-by-external-id/). ## איך זה בהשוואה | יכולת | גירוד דפים בעצמכם | API למטא-נתונים עם מסלול חינמי | amodb | | ---------------------- | ------------------------- | ------------------------------ | ---------------------------------------- | | פילמוגרפיה | סריקה של דף אחד לכל קרדיט | ראו במסמכים שלהם | `combined_credits` בקריאה אחת | | הפרדה בין שחקנים וצוות | ניתוח כותרות של מקטעים | ראו במסמכים שלהם | המערכים `cast` ו-`crew` | | תמונות | הורדה ושינוי גודל בעצמכם | ראו במסמכים שלהם | גדלים קבועים ב-`img.amodb.dev`, בלי מפתח | | חיפוש לפי שם | הפעלת טופס חיפוש של אתר | ראו במסמכים שלהם | `GET /3/search/person` | | מיפוי מזהים | התאמה לפי שם | ראו במסמכים שלהם | `/3/find` עם `imdb_id` | | שפות | אזור שפה אחד לכל אתר | ראו במסמכים שלהם | 14 שפות דרך `language` | ## תמחור משלמים מראש על 1, 3, 6, 12 או 24 חודשים. תקופות ארוכות יותר מקנות 0, 10, 20, 30 או 40 אחוז הנחה, והמסלולים לא מתחדשים מעצמם. שלושת המסלולים מאפשרים 20, 40 ו-120 בקשות לדקה, וכל אחד מחזיר את כל נקודות הקצה של אנשים. רשת שחקנים לסרט עולה בקשת קרדיטים אחת, כי שמות ונתיבי פרופיל מגיעים איתה, ועמוד אדם עולה בקשה אחת עם קרדיטים מצורפים. בחרו את הקצב שמתאים לצפיות בעמודים שלכם. אין מסלול חינמי. התחילו בעמוד [תמחור](https://amodb.dev/he/pricing/). ## שאלות ותשובות ### איך מקבלים את כל הסרטים והסדרות ששחקן הופיע בהם? קראו ל-GET /3/person/{person_id}/combined_credits, או הוסיפו append_to_response=combined_credits לקריאת האדם. המערך cast מכיל תפקידים מסרטים ומטלוויזיה, וכל אחד מסומן ב-media_type, ולכן בקשה אחת מכסה את כל הפילמוגרפיה. ### אפשר למצוא שחקן לפי שם? כן. GET /3/search/person עם פרמטר query מחזיר אנשים תואמים עם מזהים, שמות ונתיבי פרופיל. תוצאות חיפוש נשמרות במטמון 10 דקות, ולכן חיפושים חוזרים של שם פופולרי זולים. ### מאיפה מגיעות תמונות השחקנים והאם הן דורשות מפתח? לכל אדם יש profile_path. חברו אותו אל https://img.amodb.dev/t/p/{size} עם גודל כמו w185 או h632. בקשות תמונה לא דורשות מפתח, והקצה שומר תמונות 30 יום. ### איך מתאימים שחקן למזהה שם של IMDb? קראו ל-GET /3/find/{external_id}?external_source=imdb_id וקראו את person_results. גם רשומת האדם מחזירה imdb_id, ולכן אפשר לשמור את שני המזהים זה לצד זה ולחפש בשני הכיוונים. ### האם יש ביוגרפיות בשפות אחרות? כן, דרך הפרמטר language, ל-14 השפות המוגשות. השם עוקב אחרי השפה שלכם כשיש תרגום. כשלביוגרפיה אין תרגום, רשומת האדם מחזירה את הטקסט באנגלית. ## עמודים קשורים - [API פרטי אדם](https://amodb.dev/he/people/): API פרטי אדם עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו שחקן או איש צוות לפי מזהה, עם ביוגרפיה, פילמוגרפיה, מזהים חיצוניים, תמונות פרופיל והרשימה הפופולרית. - [API קרדיטים](https://amodb.dev/he/credits/): API קרדיטים עם אותם נתיבים ו-JSON כמו TMDB v3. קבלו שחקנים וצוות של סרטים, סדרות, עונות ופרקים, עם credit_id, order, department ו-job ועם guest_stars בפרקים. - [API תמונות ושרת תמונות](https://amodb.dev/he/images-api/): API תמונות סרטים עם נתיבי TMDB v3: הציגו פוסטרים, תמונות רקע, לוגואים ותמונות סצנה לכל כותר, וטענו אותם מ-img.amodb.dev ב-10 גדלים בלי מפתח. - [API חיפוש](https://amodb.dev/he/search/): API חיפוש עם אותם נתיבים ו-JSON כמו TMDB v3. מצאו סרטים, סדרות, אנשים, אוספים, חברות ומילות מפתח לפי טקסט, עם סינון לפי שנה ועימוד של 20 תוצאות בעמוד. - [חיפוש לפי מזהה חיצוני](https://amodb.dev/he/find-by-external-id/): חפשו סרט, סדרה או אדם לפי מזהה IMDb, TVDB, Wikidata או Kinopoisk עם נקודת הקצה find של TMDB v3, וקראו מזהים חיצוניים ועובדות Wikidata על כל כותר. - [מדריך למתחילים](https://amodb.dev/he/quickstart/): בצעו את הקריאה הראשונה ל-amodb: קבלו מפתח, בקשו פרטי סרט ב-curl, JavaScript, Python, PHP או Go, ואז טענו את הפוסטר מ-img.amodb.dev. פחות מ-2 דקות. עודכן: 2026-10-18. Source: https://amodb.dev/he/actor-api/