# API de atores > A API de atores é a família de pessoas do TMDB v3 em api.amodb.dev/3. Busque uma pessoa com GET /3/person/{person_id}, adicione combined_credits para a filmografia completa e images para as fotos de perfil. Lista de populares, busca por nome e consulta por ID do IMDb usam a mesma chave e o mesmo formato JSON. ## Consulte um ator e sua filmografia `GET /3/person/{person_id}` retorna biografia, dados de nascimento e o caminho da imagem de perfil de uma pessoa. Adicione `append_to_response=combined_credits` e a mesma resposta traz também todos os créditos de filmes e séries de TV. Os IDs são os IDs numéricos de pessoa que o TMDB usa, por exemplo `31` para Tom Hanks. Você recebe um registro da pessoa, a filmografia de elenco e equipe técnica, fotos de perfil e listas para descoberta. Atores, diretores e roteiristas ficam nos mesmos endpoints e se diferenciam por `known_for_department`. ## Quais dados você recebe | Endpoint | Retorna | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `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` | Papéis em filmes em `cast` e funções em `crew` | | `GET /3/person/{person_id}/tv_credits` | O mesmo para séries | | `GET /3/person/{person_id}/combined_credits` | Filmes e séries de TV em uma só lista, marcados por `media_type` | | `GET /3/person/{person_id}/images` | Um array `profiles` de fotos | | `GET /3/person/popular` | Lista paginada de pessoas populares | | `GET /3/search/person` | Pessoas que correspondem a uma `query` | ## Comece em 3 passos 1. Escolha um plano em [preços](https://amodb.dev/pt/pricing/). Todos os planos retornam os mesmos dados e diferem apenas nas requisições por minuto. 2. Gere uma chave no painel da sua conta. 3. Envie `GET /3/person/31` com `Authorization: Bearer YOUR_API_KEY`, ou use `api_key` na string de consulta. ## Exemplo de requisição Esta chamada busca Tom Hanks com seus créditos combinados. O exemplo em Python mantém os papéis em filmes que têm data de lançamento, ordena do mais recente ao mais antigo e imprime cinco, além da URL da 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") ``` Resposta reduzida para `language=en-US`. `combined_credits` foi cortado para 2 linhas de elenco e 1 de equipe técnica, e a biografia foi encurtada. ```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" } ] } } ``` ## Monte uma filmografia Uma pessoa pode aparecer em `cast` e em `crew` do mesmo título, por exemplo um ator que também dirige. Trate os dois arrays como listas separadas e junte-os na sua própria exibição. As linhas de filmes e de séries usam nomes de campo diferentes, então leia o correto. | Campo | Linhas | Significado | | ---------------------------------- | ----------------------------- | ------------------------------------- | | `media_type` | créditos combinados | `movie` ou `tv` | | `title` ou `name` | linhas de filmes ou de séries | Título de exibição | | `release_date` ou `first_air_date` | linhas de filmes ou de séries | Chave de ordenação, pode estar vazia | | `character` | elenco | Nome do papel | | `job`, `department` | equipe técnica | Por exemplo `Director` em `Directing` | | `credit_id` | ambas | ID da linha de crédito | Ordene por data, coloque as linhas sem data no fim e remova duplicatas pelo par `id` e `media_type`. As linhas de elenco de séries trazem `episode_count`, mas o amodb retorna `0` ali, então não use esse campo para contar episódios. O amodb não oferece `GET /3/credit/{credit_id}` nem `aggregate_credits`. Os detalhes dos campos de elenco e equipe técnica estão em [créditos](https://amodb.dev/pt/credits/). ## Fotos de perfil `profile_path` se junta ao host de imagens: `https://img.amodb.dev/t/p/{size}{profile_path}`. Use `w185` para miniaturas de lista, `h632` para uma página de perfil e `original` para downloads. As imagens não exigem chave e ficam em cache por 30 dias. Para mais de uma foto, chame `GET /3/person/{person_id}/images`. O array `profiles` tem `file_path`, `width`, `height`, `aspect_ratio` e `vote_average`, então você pode escolher o retrato mais bem avaliado. As tabelas de tamanhos e `srcset` estão em [imagens](https://amodb.dev/pt/images-api/). ## Pessoas populares, busca e consulta por ID - `GET /3/person/popular?page=1` retorna uma lista paginada. As páginas vão de 1 a 500, e a lista fica em cache por 30 minutos. - `GET /3/search/person?query=tom+hanks` busca por nome. Fica em cache por 10 minutos. - `GET /3/find/{external_id}?external_source=imdb_id` associa um ID de nome do IMDb a uma pessoa. Leia `person_results` na resposta. Veja [busca por ID externo](https://amodb.dev/pt/find-by-external-id/). ## Como se compara | Recurso | Fazer scraping das páginas você mesmo | API de metadados com plano gratuito | amodb | | --------------------------------------- | ---------------------------------------- | ----------------------------------- | -------------------------------------------- | | Filmografia | Rastrear uma página por crédito | Consulte a documentação deles | `combined_credits` em uma única chamada | | Separação entre elenco e equipe técnica | Analisar os títulos das seções | Consulte a documentação deles | Arrays `cast` e `crew` | | Fotos | Baixar e redimensionar por conta própria | Consulte a documentação deles | Tamanhos fixos em `img.amodb.dev`, sem chave | | Busca por nome | Usar o formulário de busca de um site | Consulte a documentação deles | `GET /3/search/person` | | Associação de IDs | Associar pelo nome | Consulte a documentação deles | `/3/find` com `imdb_id` | | Idiomas | Um idioma por site | Consulte a documentação deles | 14 idiomas via `language` | ## Preços Pague adiantado por 1, 3, 6, 12 ou 24 meses. Os períodos mais longos têm desconto de 0, 10, 20, 30 ou 40 por cento, e os planos nunca renovam sozinhos. Os três planos permitem 20, 40 e 120 requisições por minuto, e cada um retorna todos os endpoints de pessoas. Uma grade de elenco de um filme custa uma requisição de créditos, porque nomes e caminhos de perfil já vêm nela, e a página de uma pessoa custa uma requisição com os créditos anexados. Escolha o limite que atende às visualizações de página do seu site. Sem plano gratuito. Comece em [preços](https://amodb.dev/pt/pricing/). ## Perguntas e respostas ### Como obtenho todos os filmes e séries em que um ator atuou? Chame GET /3/person/{person_id}/combined_credits ou adicione append_to_response=combined_credits à chamada da pessoa. O array cast traz os papéis em filmes e séries de TV, cada um marcado com media_type, então uma única requisição cobre toda a filmografia. ### Posso encontrar um ator pelo nome? Sim. GET /3/search/person com o parâmetro query retorna as pessoas correspondentes com IDs, nomes e caminhos de perfil. Os resultados de busca ficam em cache por 10 minutos, então consultas repetidas de um nome popular saem baratas. ### De onde vêm as fotos dos atores e elas exigem chave? Cada pessoa tem um profile_path. Junte-o a https://img.amodb.dev/t/p/{size} com um tamanho como w185 ou h632. As requisições de imagem não exigem chave, e a borda mantém as imagens por 30 dias. ### Como associo um ator a um ID de nome do IMDb? Chame GET /3/find/{external_id}?external_source=imdb_id e leia person_results. O registro da pessoa também retorna imdb_id, então você pode guardar os dois IDs lado a lado e consultar nos dois sentidos. ### As biografias estão disponíveis em outros idiomas? Sim, pelo parâmetro language, nos 14 idiomas atendidos. O nome segue o seu idioma quando existe tradução. Quando uma biografia não tem tradução, o registro da pessoa retorna o texto em inglês. ## Páginas relacionadas - [API de detalhes de pessoas](https://amodb.dev/pt/people/): API de detalhes de pessoas com os caminhos e o JSON do TMDB v3. Busque um ator ou membro da equipe por id, com biografia, filmografia e ids externos. - [API de créditos](https://amodb.dev/pt/credits/): API de créditos com caminhos e JSON iguais aos do TMDB v3. Elenco e equipe técnica de filmes, séries, temporadas e episódios, com order, department e job. - [API de imagens e host de imagens](https://amodb.dev/pt/images-api/): API de imagens de filmes com caminhos do TMDB v3: liste pôsteres, backdrops, logos e stills por título e carregue-os de img.amodb.dev em 10 tamanhos, sem chave. - [API de busca](https://amodb.dev/pt/search/): API de busca com caminhos e JSON do TMDB v3. Encontre filmes, séries, pessoas, coleções, produtoras e palavras-chave por texto, com filtro de ano e paginação. - [Buscar por ID externo](https://amodb.dev/pt/find-by-external-id/): Busque um filme, série ou pessoa por id do IMDb, TVDB, Wikidata ou Kinopoisk com o endpoint find do TMDB e leia ids externos e dados do Wikidata de um título. - [Início rápido](https://amodb.dev/pt/quickstart/): Faça sua primeira chamada ao amodb: obtenha uma chave, peça um filme em curl, JavaScript, Python, PHP ou Go e carregue o pôster. Menos de 2 minutos. Atualizado: 2026-10-18. Source: https://amodb.dev/pt/actor-api/