API de actores

Consulta un actor y su filmografía

GET /3/person/{person_id} devuelve la biografía, los datos de nacimiento y la ruta de la imagen de perfil de una persona. Añade append_to_response=combined_credits y la misma respuesta incluye también todos los créditos de cine y TV. Los ids son los ids numéricos de persona que usa TMDB, por ejemplo 31 para Tom Hanks.

Obtienes un registro de persona, una filmografía de reparto y equipo técnico, fotos de perfil y listas para descubrir. Actores, directores y guionistas viven en los mismos endpoints y se distinguen por known_for_department.

Qué datos obtienes

Empieza en 3 pasos

1. Elige un plan en precios. Todos los planes devuelven los mismos datos y solo se diferencian en las solicitudes por minuto.
2. Genera una clave en el panel de tu cuenta.
3. Envía GET /3/person/31 con Authorization: Bearer YOUR_API_KEY, o usa api_key en la cadena de consulta.

Ejemplo de solicitud

Esta llamada obtiene a Tom Hanks con sus créditos combinados. El ejemplo en Python conserva los papeles de película que tienen fecha de estreno, los ordena del más reciente al más antiguo e imprime cinco, además de la URL de la foto.

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")

Respuesta recortada para language=en-US. combined_credits se reduce a 2 filas de reparto y 1 de equipo técnico, y la biografía está acortada.

{
  "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"
      }
    ]
  }
}

Crea una filmografía

Una persona puede aparecer en cast y en crew del mismo título, por ejemplo un actor que también dirige. Trata los dos arrays como listas separadas y únelas en tu propia vista. Las filas de películas y de TV usan nombres de campo distintos, así que lee el correcto.

Ordena por fecha, pon al final las filas sin fecha y elimina duplicados con el par id y media_type. Las filas de reparto de TV traen episode_count, pero amodb devuelve 0 ahí, así que no lo uses para contar episodios. amodb no ofrece GET /3/credit/{credit_id} ni aggregate_credits. Los detalles de los campos de reparto y equipo técnico están en créditos.

Fotos de perfil

profile_path se une al host de imágenes: https://img.amodb.dev/t/p/{size}{profile_path}. Usa w185 para miniaturas de lista, h632 para una página de perfil y original para descargas. Las imágenes no necesitan clave y se guardan en caché 30 días.

Para más de una foto llama a GET /3/person/{person_id}/images. El array profiles trae file_path, width, height, aspect_ratio y vote_average, así que puedes elegir el retrato mejor valorado. Las tablas de tamaños y srcset están en imágenes.

Personas populares, búsqueda y consulta por ID

• GET /3/person/popular?page=1 devuelve una lista paginada. Las páginas van de 1 a 500, y la lista se guarda en caché 30 minutos.
• GET /3/search/person?query=tom+hanks busca por nombre. En caché 10 minutos.
• GET /3/find/{external_id}?external_source=imdb_id convierte un ID de nombre de IMDb en una persona. Lee person_results en la respuesta. Consulta buscar por ID externo.

Cómo se compara

Precios

Paga por adelantado 1, 3, 6, 12 o 24 meses. Los periodos más largos tienen un descuento de 0, 10, 20, 30 o 40 por ciento, y los planes nunca se renuevan solos. Los tres planes permiten 20, 40 y 120 solicitudes por minuto, y cada uno devuelve todos los endpoints de personas. Una cuadrícula de reparto para una película cuesta una solicitud de créditos, porque los nombres y las rutas de perfil vienen incluidos, y una página de persona cuesta una solicitud con los créditos añadidos. Elige el límite que se ajuste a tus visitas de página. No hay nivel gratuito. Empieza en precios.