# API de actores > La API de actores es la familia de personas de TMDB v3 en api.amodb.dev/3. Consulta una persona con GET /3/person/{person_id}, añade combined_credits para la filmografía completa e images para las fotos de perfil. Una lista popular, la búsqueda por nombre y la consulta por ID de IMDb usan la misma clave y el mismo formato JSON. ## 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 | Endpoint | Devuelve | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `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` | Papeles de película en `cast` y puestos en `crew` | | `GET /3/person/{person_id}/tv_credits` | Lo mismo para series | | `GET /3/person/{person_id}/combined_credits` | Películas y TV en una sola lista, marcadas con `media_type` | | `GET /3/person/{person_id}/images` | Un array `profiles` de fotos | | `GET /3/person/popular` | Lista paginada de personas populares | | `GET /3/search/person` | Personas que coinciden con un `query` | ## Empieza en 3 pasos 1. Elige un plan en [precios](https://amodb.dev/es/pricing/). 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. ```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") ``` 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. ```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" } ] } } ``` ## 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. | Campo | Filas | Significado | | --------------------------------- | -------------------------- | ------------------------------------- | | `media_type` | créditos combinados | `movie` o `tv` | | `title` o `name` | filas de películas o de TV | Título para mostrar | | `release_date` o `first_air_date` | filas de películas o de TV | Clave de orden, puede estar vacía | | `character` | reparto | Nombre del papel | | `job`, `department` | equipo técnico | Por ejemplo `Director` en `Directing` | | `credit_id` | ambas | Id de la fila de crédito | 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](https://amodb.dev/es/credits/). ## 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](https://amodb.dev/es/images-api/). ## 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](https://amodb.dev/es/find-by-external-id/). ## Cómo se compara | Capacidad | Hacer scraping de las páginas tú mismo | API de metadatos con nivel gratuito | amodb | | ------------------------------------- | --------------------------------------------- | ----------------------------------- | ------------------------------------------- | | Filmografía | Rastrear una página por crédito | Consulta su documentación | `combined_credits` en una sola llamada | | Reparto y equipo técnico por separado | Analizar los títulos de sección | Consulta su documentación | Arrays `cast` y `crew` | | Fotos | Descargar y redimensionar tú mismo | Consulta su documentación | Tamaños fijos en `img.amodb.dev`, sin clave | | Búsqueda por nombre | Manejar el formulario de búsqueda de un sitio | Consulta su documentación | `GET /3/search/person` | | Mapeo de ids | Emparejar por nombre | Consulta su documentación | `/3/find` con `imdb_id` | | Idiomas | Un idioma por sitio | Consulta su documentación | 14 idiomas con `language` | ## 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](https://amodb.dev/es/pricing/). ## Preguntas y respuestas ### ¿Cómo obtengo todas las películas y series en las que ha actuado una persona? Llama a GET /3/person/{person_id}/combined_credits o añade append_to_response=combined_credits a la llamada de la persona. El array cast contiene los papeles de cine y TV, cada uno marcado con media_type, así que una sola solicitud cubre toda la filmografía. ### ¿Puedo encontrar a un actor por su nombre? Sí. GET /3/search/person con el parámetro query devuelve las personas que coinciden, con ids, nombres y rutas de perfil. Los resultados de búsqueda se guardan en caché 10 minutos, así que repetir la consulta de un nombre popular sale barato. ### ¿De dónde salen las fotos de los actores y hace falta clave? Cada persona tiene un profile_path. Únelo a https://img.amodb.dev/t/p/{size} con un tamaño como w185 o h632. Las solicitudes de imágenes no necesitan clave, y la caché perimetral guarda las imágenes 30 días. ### ¿Cómo relaciono un actor con un ID de nombre de IMDb? Llama a GET /3/find/{external_id}?external_source=imdb_id y lee person_results. El registro de la persona también devuelve imdb_id, así que puedes guardar ambos ids juntos y buscar en cualquiera de las dos direcciones. ### ¿Las biografías están disponibles en otros idiomas? Sí, mediante el parámetro language, para los 14 idiomas disponibles. El nombre sigue tu idioma cuando existe una traducción. Si una biografía no tiene traducción, el registro de la persona devuelve el texto en inglés. ## Páginas relacionadas - [API de detalles de persona](https://amodb.dev/es/people/): API de detalles de persona con rutas y JSON de TMDB v3. Obtén un actor o miembro del equipo por id, con biografía, filmografía, ids externos y populares. - [API de créditos](https://amodb.dev/es/credits/): API de créditos con las mismas rutas y el mismo JSON que TMDB v3. Obtén reparto y equipo técnico de películas, series, temporadas y episodios con order y job. - [API de imágenes y host de imágenes](https://amodb.dev/es/images-api/): API de imágenes de películas con rutas TMDB v3: lista pósters, fondos, logos y fotogramas por título y cárgalos desde img.amodb.dev en 10 tamaños sin clave. - [API de búsqueda](https://amodb.dev/es/search/): API de búsqueda con rutas y JSON de TMDB v3. Encuentra películas, series, personas, colecciones, productoras y palabras clave por texto, con filtros de año. - [Buscar por id externo](https://amodb.dev/es/find-by-external-id/): Busca una película, serie o persona por id de IMDb, TVDB, Wikidata o Kinopoisk con el endpoint find de TMDB, y lee los ids externos y los datos de Wikidata. - [Inicio rápido](https://amodb.dev/es/quickstart/): Haz tu primera llamada a amodb: consigue una clave, pide los detalles de una película en curl, JavaScript, Python, PHP o Go y carga el póster. En 2 minutos. Actualizado: 2026-10-18. Source: https://amodb.dev/es/actor-api/