חיפוש שחקן והפילמוגרפיה שלו

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. בחרו מסלול בעמוד תמחור. כל המסלולים מחזירים את אותם נתונים ונבדלים רק בבקשות לדקה.
  2. צרו מפתח בלוח הבקרה של החשבון.
  3. שלחו GET /3/person/31 עם Authorization: Bearer YOUR_API_KEY, או השתמשו ב-api_key במחרוזת השאילתה.

בקשה לדוגמה

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

bashpy 
curl -s "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \
  -H "Authorization: Bearer $AMODB_KEY"
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. פרטי שדות השחקנים והצוות נמצאים בעמוד קרדיטים.

תמונות פרופיל

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 נמצאות בעמוד תמונות.

אנשים פופולריים, חיפוש וחיפוש לפי מזהה

  • 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 בתגובה. ראו חיפוש לפי מזהה חיצוני.

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

יכולתגירוד דפים בעצמכם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 בקשות לדקה, וכל אחד מחזיר את כל נקודות הקצה של אנשים. רשת שחקנים לסרט עולה בקשת קרדיטים אחת, כי שמות ונתיבי פרופיל מגיעים איתה, ועמוד אדם עולה בקשה אחת עם קרדיטים מצורפים. בחרו את הקצב שמתאים לצפיות בעמודים שלכם. אין מסלול חינמי. התחילו בעמוד תמחור.