Filmes e séries (IMDb)

Filmes e séries (IMDb): Informações públicas de títulos, elenco e avaliações.

Atualizado em 05/11/2026.

O que é Filmes e séries (IMDb) na APIcultura

Acesse Filmes e séries (IMDb) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Informações públicas de títulos, elenco e avaliações. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Pesquisa e conhecimento. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Informações do título (imdb-titulo)

Dados básicos de um filme ou série. Preço: R$ 0,07 por chamada.

• id (string, obrigatório)
• languageCountry (string, opcional), ex.: en_US

Schema de entrada de imdb-titulo

{
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 2000
    },
    "languageCountry": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Resumo de avaliações (imdb-avaliacoes)

Resumo das avaliações de usuários de um título. Preço: R$ 0,07 por chamada.

• id (string, obrigatório)
• languageCountry (string, opcional), ex.: en_US

Schema de entrada de imdb-avaliacoes

{
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 2000
    },
    "languageCountry": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Rankings do IMDb (imdb-rankings)

Top 250 de filmes ou séries. Preço: R$ 0,07 por chamada.

• rankingsChartType (string, obrigatório)
• languageCountry (string, opcional), ex.: en_US

Schema de entrada de imdb-rankings

{
  "required": [
    "rankingsChartType"
  ],
  "properties": {
    "rankingsChartType": {
      "type": "string",
      "maxLength": 2000
    },
    "languageCountry": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "imdb-titulo", "input": {"id":"exemplo","languageCountry":"en_US"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/imdb-titulo \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"id":"exemplo","languageCountry":"en_US"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,07 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Experimente

Teste no playground interativo: Filmes e séries (IMDb) no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Filmes e séries (IMDb) é marca de seus respectivos donos, citada apenas para identificar a integração.