API dei dettagli della persona

Ottenere i dettagli di una persona

GET /3/person/{person_id} restituisce la scheda di base di una persona: nome, biografia, data di nascita, luogo di nascita, reparto, immagine del profilo e ID IMDb. L'ID è l'ID numerico di persona di TMDB, quindi Tom Hanks resta 31 e Leonardo DiCaprio resta 6193. Chi lavora davanti e dietro la macchina da presa condivide un unico spazio di ID.

L'esempio legge Tom Hanks e aggiunge i suoi crediti combinati, poi stampa il nome, la data di nascita, il reparto principale e quanti crediti da attore ha.

curl -sSf "https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits" \
  -H "Authorization: Bearer $AMODB_KEY"

const url = 'https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits';
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` } });
if (!res.ok) throw new Error(`amodb returned ${res.status}`);
const person = await res.json();
console.log(person.name, person.birthday, person.known_for_department, person.combined_credits.cast.length);

import os
import requests

r = requests.get(
    "https://api.amodb.dev/3/person/31",
    params={"language": "en-US", "append_to_response": "combined_credits"},
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
r.raise_for_status()
person = r.json()
print(person["name"], person["birthday"], person["known_for_department"], len(person["combined_credits"]["cast"]))

<?php
$url = 'https://api.amodb.dev/3/person/31?language=en-US&append_to_response=combined_credits';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
    throw new RuntimeException("amodb returned $status");
}
$person = json_decode($body, true);
echo $person['name'], ' ', $person['birthday'], ' ', count($person['combined_credits']['cast']), PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"time"
)

type Person struct {
	Name         string `json:"name"`
	Birthday     string `json:"birthday"`
	Department   string `json:"known_for_department"`
	PlaceOfBirth string `json:"place_of_birth"`
}

func main() {
	req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/person/31?language=en-US", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
	client := &http.Client{Timeout: 10 * time.Second}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		panic(res.Status)
	}
	var p Person
	if err := json.NewDecoder(res.Body).Decode(&p); err != nil {
		panic(err)
	}
	fmt.Println(p.Name, p.Birthday, p.Department, p.PlaceOfBirth)
}

Parametri

• person_idpercorsoobbligatorio
  ID numerico della persona, per esempio 31.
• api_keyqueryuno dei due
  La tua chiave. Usa questa o l'header Authorization: Bearer.
• languagequery
  Tag TMDB come en-US o ru-RU. La biografia viene restituita in quella lingua quando esiste una traduzione.
• append_to_responsequery
  Elenco separato da virgole: movie_credits, tv_credits, combined_credits, external_ids, images. I nomi sconosciuti vengono ignorati.

Campi della risposta

Risposta di esempio

GET /3/person/31?language=en-US, con la biografia accorciata:

{
  "adult": false,
  "also_known_as": [
    "Thomas Jeffrey Hanks"
  ],
  "biography": "Thomas Jeffrey Hanks (born July 9, 1956) is an American actor and filmmaker. Known for both his comedic and dramatic roles, Hanks is one of the most popular...",
  "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"
}

Endpoint della filmografia

Tre endpoint elencano i lavori di una persona. Tutti accettano language e restituiscono le chiavi id, cast e crew. Quando li aggiungi con append_to_response, la chiave id viene omessa.

Le voci dei film portano title e release_date. Le voci delle serie TV portano name e first_air_date, e le voci di cast delle serie contengono anche una chiave episode_count che nei dati attuali è 0. Le voci portano anche credit_id, genre_ids, poster_path, vote_average e gli altri campi di lista. Il frammento qui sotto ordina i crediti combinati per data e stampa i cinque più recenti.

const credits = person.combined_credits;
const date = (c) => c.release_date || c.first_air_date || '';
const latest = credits.cast.filter((c) => date(c)).sort((a, b) => date(b).localeCompare(date(a))).slice(0, 5);
for (const c of latest) console.log(date(c), c.media_type, c.title || c.name, 'as', c.character);

Liste e immagini

Le voci dei popolari contengono id, name, original_name, known_for_department, gender, profile_path, popularity e un array known_for. Le pagine vanno da 1 a 500. Le foto del profilo sono trattate nella pagina immagini, e gli ID esterni nella pagina ricerca per ID esterno.

amodb non offre traduzioni delle persone, la scheda di persona più recente, immagini taggate né modifiche. Chiedi invece la biografia nella lingua che ti serve con il parametro language.

Errori

L'elenco completo è nella pagina errori, e le finestre per piano sono in limiti di richieste.

Note pratiche

• I dettagli della persona e le liste dei crediti restano in cache per 6 ore. La lista dei popolari resta in cache per 30 minuti e le sue pagine vanno da 1 a 500.
• Aggiungi combined_credits tramite append_to_response invece di fare una seconda chiamata. Entrambi i modi restituiscono gli stessi dati.
• In movie_credits, ogni voce di cast ha un valore order, la posizione della persona nel cast di quel film. Le voci delle serie TV non hanno order, quindi ordinale per first_air_date.
• Usa known_for_department per decidere quale lista mostrare per prima: cast per gli attori, crew per registi e sceneggiatori.
• Cerca una persona per nome nella pagina ricerca, poi usa qui l'ID.