Introdução

A API EmbedMovies permite integrar players de filmes e séries diretamente em seu site através de iframes. Nossa API suporta IDs do TMDb (The Movie Database) e IMDb (Internet Movie Database).

Importante: Os players só funcionam quando embutidos em iframes. Acesso direto às URLs não reproduzirá o conteúdo.

Todas as requisições são feitas via URL simples, sem necessidade de autenticação ou chaves de API para uso básico. Basta construir a URL correta e inserir em um iframe.

Embed de Filmes

Para embutir um filme, utilize a estrutura abaixo. O ID pode ser tanto do TMDb quanto do IMDb.

Estrutura da URL
https://cdn-embed.com/filme/{$id}

Exemplo com ID do TMDb: https://cdn-embed.com/filme/550 (Clube da Luta)

Exemplo com ID do IMDb: https://cdn-embed.com/filme/tt0137523 (Clube da Luta)

Parâmetros

Parâmetro Tipo Obrigatório Descrição
{$id} String/Number Obrigatório ID do filme no TMDb (número) ou IMDb (string com prefixo "tt")

Embed de Séries (Todas as Temporadas)

Para listar todas as temporadas e episódios de uma série, utilize a estrutura abaixo.

Estrutura da URL
https://cdn-embed.com/serie/{$id}

Exemplo com ID do TMDb: https://cdn-embed.com/serie/1396 (Breaking Bad)

Exemplo com ID do IMDb: https://cdn-embed.com/serie/tt0903747 (Breaking Bad)

Parâmetros

Parâmetro Tipo Obrigatório Descrição
{$id} String/Number Obrigatório ID da série no TMDb (número) ou IMDb (string com prefixo "tt")

Episódio Específico

Para acessar diretamente um episódio específico de uma temporada, utilize a estrutura completa.

Estrutura da URL
https://cdn-embed.com/serie/{$id}/{$season_number}/{$episode_number}

Exemplo: https://cdn-embed.com/serie/1396/5/14 (Breaking Bad - Temporada 5, Episódio 14)

Com IMDb: https://cdn-embed.com/serie/tt0903747/5/14

Parâmetros

Parâmetro Tipo Obrigatório Descrição
{$id} String/Number Obrigatório ID da série no TMDb ou IMDb
{$season_number} Number Obrigatório Número da temporada (ex: 1, 2, 3)
{$episode_number} Number Obrigatório Número do episódio dentro da temporada (ex: 1, 2, 3)

Exemplos de Código

Como implementar os players em seu site usando iframes.

Exemplo: Filme

<iframe
  src="https://cdn-embed.com/filme/550"
  width="100%"
  height="600"
  frameborder="0"
  allowfullscreen
  loading="lazy"
></iframe>

Exemplo: Série (Todas as Temporadas)

<iframe
  src="https://cdn-embed.com/serie/1396"
  width="100%"
  height="700"
  frameborder="0"
  allowfullscreen
  loading="lazy"
></iframe>

Exemplo: Episódio Específico

<iframe
  src="https://cdn-embed.com/serie/1396/5/14"
  width="100%"
  height="600"
  frameborder="0"
  allowfullscreen
  loading="lazy"
></iframe>
Recomendações de Tamanho

Filmes: height="600"

Séries (listagem): height="700"

Episódio único: height="600"

Mobile: Use height responsivo com CSS

Versão Mobile
<style>
  iframe {
    width: 100% !important;
    height: auto !important;
    aspect-ratio: 16/9;
  }
</style>

Notas Importantes

Acesso Direto Bloqueado: As URLs não funcionam quando acessadas diretamente no navegador. Devem ser sempre usadas dentro de iframes.
Responsividade: Recomendamos usar width="100%" e definir altura fixa ou usar CSS com aspect-ratio para melhor experiência mobile.

Compatibilidade de IDs

Nossa API aceita ambos os formatos de ID:

  • TMDb: Números inteiros (ex: 550, 1396)
  • IMDb: Strings com prefixo "tt" (ex: tt0137523, tt0903747)

Política de Uso

O uso da API EmbedMovies é gratuito para sites pessoais e pequenos projetos. Para uso comercial em larga escala ou sites com alto tráfego, entre em contato para discutir termos de uso.

Suporte a Formatos

Todos os players são otimizados para funcionar em:

  • Chrome, Firefox, Safari, Edge (versões modernas)
  • Dispositivos mobile (iOS 12+, Android 8+)
  • Smart TVs com navegadores modernos