# Filmes e séries (IMDb)

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

URL: https://apicultura.app/ferramentas/filmes-imdb/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=pesquisa). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `imdb-titulo` | Informações do título | R$ 0,07 | `POST /v1/call/imdb-titulo` |
| `imdb-avaliacoes` | Resumo de avaliações | R$ 0,07 | `POST /v1/call/imdb-avaliacoes` |
| `imdb-rankings` | Rankings do IMDb | R$ 0,07 | `POST /v1/call/imdb-rankings` |

### 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

```json
{
  "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

```json
{
  "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

```json
{
  "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:

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

## Exemplo de chamada HTTP

```bash
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](/ferramentas/ferramenta.html?slug=filmes-imdb). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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