Documentação da API
Acesse programaticamente nosso banco de dados com milhares de filmes e séries. Integração simples e rápida para seu projeto.
https://api.moviendb.com/v1/
Visão Geral
A API do Moviendb fornece acesso programático ao nosso extenso banco de dados de filmes e séries. Todos os endpoints retornam dados em formato JSON e seguem padrões RESTful.
Informações Importantes
• Todas as requisições devem incluir sua API Key no header
• O limite de requisições varia conforme seu plano
• Os dados são cacheados por 6 horas para melhor performance
• Rate limit é resetado diariamente à meia-noite UTC
Atenção
• Não compartilhe sua API Key publicamente
• Requisições sem autenticação serão bloqueadas
Autenticação
Para usar a API, você precisa incluir sua chave API em todas as requisições. Adicione o header X-API-Key com sua chave única.
Método Recomendado
Envie a API Key no header X-API-Key para todas as requisições.
Exemplos de Código
<?php
$ch = curl_init("https://api.moviendb.com/v1/movie");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-Key: sua_chave_api'
]);
$response = curl_exec($ch);
$data = json_decode($response, true);fetch('https://api.moviendb.com/v1/movie', {
headers: {
'X-API-Key': 'sua_chave_api'
}
})
.then(res => res.json())
.then(data => console.log(data));import requests
headers = {'X-API-Key': 'sua_chave_api'}
response = requests.get(
'https://api.moviendb.com/v1/movie',
headers=headers
)
data = response.json()Rate Limits
Cada plano tem um limite diário de requisições. Quando o limite é atingido, a API retorna o erro NO_CREDITS.
Reset Diário
O contador de requisições é resetado diariamente à meia-noite UTC.
| Plano | Requisições/Dia | Requisições/Segundo |
|---|---|---|
| Free | 5.000 | 10 |
| Pro | 15.000 | 50 |
| Enterprise | 50.000 | 100 |
Lista de Filmes
Retorna uma lista paginada de filmes. Suporta diversos parâmetros de filtragem e ordenação.
Parâmetros
| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| pageopcional | integer | Número da página | 1, 2, 3... |
| sort_byopcional | string | Ordenação | id.desc, popularity.asc |
| is_animeopcional | string | Filtrar animes | true, false |
| yearopcional | integer | Ano de lançamento | 2024, 2025 |
Testar Endpoint
Lista de Séries
Retorna uma lista paginada de séries. Mesmos parâmetros do endpoint de filmes.
Parâmetros
| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| pageopcional | integer | Número da página | 1, 2, 3... |
| sort_byopcional | string | Ordenação | id.desc, popularity.asc |
| is_animeopcional | string | Filtrar animes | true, false |
| yearopcional | integer | Ano de lançamento | 2024, 2025 |
Testar Endpoint
Detalhes do Filme
Retorna detalhes completos de um filme específico. O ID pode ser TMDB ou IMDB.
Parâmetros
| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| idobrigatório | string | ID do TMDB ou IMDB | 87659, tt13515760 |
Testar Endpoint
Detalhes da Série
Retorna detalhes completos de uma série específica, incluindo temporadas e episódios.
Parâmetros
| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| idobrigatório | string | ID do TMDB ou IMDB | 46749, tt27497448 |
Testar Endpoint
Pesquisa
Pesquisa por filmes e séries. Retorna resultados similares ao endpoint de lista.
Parâmetros
| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| qobrigatório | string | Termo de pesquisa | breaking bad |
| pageopcional | integer | Número da página | 1, 2, 3... |
Testar Endpoint
Planos & Preços
Escolha o plano ideal para suas necessidades. Todos os planos incluem acesso completo a todos os endpoints.
Free
- 5.000 requisições/dia
- Acesso a todos endpoints
- Suporte por email
- Cache de 6 horas
- Suporte prioritário
Pro
- 15.000 requisições/dia
- Acesso a todos endpoints
- Suporte prioritário
- Cache de 6 horas
- SLA 99.9%
Enterprise
- 50.000 requisições/dia
- Acesso a todos endpoints
- Suporte 24/7
- Cache de 6 horas
- SLA 99.99%
Códigos de Erro
Em caso de erro, a API retornará um objeto com detalhes sobre o problema.
API_KEY_INVALID
Chave API inválida ou não fornecida. Verifique se o header X-API-Key está correto.
API_KEY_DISABLED
Sua chave API foi desativada. Entre em contato com o suporte.
NO_CREDITS
Seus créditos diários foram esgotados. Aguarde a renovação.
NOT_FOUND
O conteúdo solicitado não foi encontrado.
{
"success": false,
"error": {
"code": "API_KEY_INVALID",
"message": "Invalid API key"
}
}Solicitar Chave API
Preencha seu email abaixo para receber sua chave API gratuitamente.