v2.1.0 — Estável

📖 Documentação da API

Integre o StreamAPI em qualquer site, aplicativo ou plataforma. Nossa API RESTful é simples, rápida e segura. Cada requisição válida com sua API Key registra a visualização e gera renda para você.

Introdução

A StreamAPI fornece um sistema completo para hospedar e monetizar players de vídeo. Ao incorporar nosso player com sua API Key, cada visualização é registrada e creditada na sua conta.

💡 URL do player embed: carregando...
endpoint base
# URL do player embed
carregando...

Autenticação

Todas as requisições devem incluir sua API Key. Você pode passá-la como parâmetro de query na URL do embed.

⚠️ Nunca exponha sua API Key em repositórios públicos.

Via Query Parameter

url carregando...

Embed Player

O endpoint principal. Renderiza um player de vídeo que registra visualizações automaticamente.

GET/embed/api.php
Renderiza o player de vídeo para o conteúdo especificado.
ParâmetroTipoObrigatórioDescrição
tmdbintegerSimID TMDB do conteúdo
apistringSimSua API Key (sk_live_...)
typestringNãomovie ou tv (padrão: movie)
seasonintegerNãoNº da temporada (apenas séries)
epintegerNãoNº do episódio (apenas séries)

Exemplo — Filme

html <!-- iFrame para Interestelar -->
<iframe
  src="carregando..."
  width="100%"
  height="500"
  frameborder="0"
  allowfullscreen
  allow="autoplay; encrypted-media; fullscreen">
</iframe>

Exemplo — Série

html <!-- Breaking Bad S01E01 -->
<iframe
  src="carregando..."
  width="100%"
  height="500"
  frameborder="0"
  allowfullscreen>
</iframe>

Conteúdo

GET/content
Lista todo o catálogo de filmes e séries disponíveis.
ParâmetroTipoDescrição
typestringFiltrar: movie, series ou anime
qstringBusca por título
pageintegerPágina (padrão: 1)
limitintegerItens por página (máx: 50)

Resposta

json{
  "success": true,
  "page": 1,
  "total": 5234,
  "data": [
    {
      "tmdb_id": 157336,
      "title": "Interestelar",
      "type": "movie",
      "release_year": 2014,
      "poster_url": "https://image.tmdb.org/..."
    }
  ]
}

Estatísticas

GET/user/stats
Retorna suas estatísticas de visualizações e ganhos.
json{
  "views_total": 12542,
  "views_today": 342,
  "views_this_month": 8940,
  "earned_total": "$12.54",
  "earned_pending": "$3.40",
  "earned_paid": "$9.14"
}

Códigos de Erro

CódigoSignificadoSolução
400Requisição inválidaVerifique os parâmetros enviados
401API Key inválidaVerifique sua API Key no dashboard
403Conta suspensaEntre em contato com o suporte
404Conteúdo não encontradoVerifique o ID TMDB
429Rate limit excedidoAguarde e tente novamente
500Erro interno do servidorTente novamente em alguns segundos

Rate Limits

Para garantir a estabilidade da plataforma, aplicamos limites de requisição por plano.

1.000
req/hora — Gratuito
10.000
req/hora — Pro
∞
req/hora — Enterprise
⚠️ Views do mesmo IP em menos de 30 minutos não são contabilizadas. O player precisa ficar ativo por pelo menos 60 segundos.

Exemplos Completos

HTML iFrame

html carregando...

JavaScript (Fetch)

javascript // Buscar catálogo de filmes
const response = await fetch('carregando...');
const data = await response.json();
console.log(data.total); // 5234