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.

Ver planos Ler o guia rápido

Requisição

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

Resposta 200

{
  "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",

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

Escolha um plano em preços. Todos os planos retornam os mesmos dados e diferem apenas nas requisições por minuto.
Gere uma chave no painel da sua conta.
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.

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

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.

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.

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.

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.

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.

Atualizado em 18 de out. de 2026

Ver em Markdown