Guia · API

API REST limpa, autenticação por chave.

Endpoints REST simples, JSON puro, autenticação Bearer. Sem GraphQL, sem cerimônia.

Base URL e autenticação

Base: https://leadplayer.com.br/api/v1
Header: Authorization: Bearer SEU_API_KEY

Gere a API key em Configurações → API Keys. Cada key pode ser revogada individualmente, e o painel mostra última utilização.

Listar vídeos

curl https://leadplayer.com.br/api/v1/videos \
  -H "Authorization: Bearer SEU_API_KEY"

{
  "data": [
    { "id": "vid_abc", "title": "VSL Black Friday", "duration_sec": 1820, "created_at": "2026-06-01T10:00:00Z" }
  ],
  "next_cursor": null
}

Obter eventos de um vídeo

curl "https://leadplayer.com.br/api/v1/videos/vid_abc/events?since=2026-06-20" \
  -H "Authorization: Bearer SEU_API_KEY"

{
  "data": [
    { "event": "watched_90", "visitor_id": "vis_x", "timestamp": "2026-06-23T14:22:00Z" }
  ],
  "next_cursor": "evt_def..."
}

Paginação por cursor: passe o next_cursor retornado no parâmetro cursor da próxima chamada.

Consultar Lead Intent Score

curl https://leadplayer.com.br/api/v1/visitors/vis_x/score \
  -H "Authorization: Bearer SEU_API_KEY"

{
  "visitor_id": "vis_x",
  "score": 82,
  "factors": {
    "watched_percent": 0.91,
    "focus_time_ratio": 0.86,
    "cta_clicks": 1,
    "rewinds": 2
  },
  "computed_at": "2026-06-24T13:00:00Z"
}

Códigos de erro

  • 401 — API key inválida ou ausente
  • 403 — recurso pertence a outro tenant
  • 404 — recurso inexistente
  • 422 — corpo da requisição inválido (campo obrigatório faltando, tipo errado)
  • 429 — rate limit; respeite o header Retry-After
  • 5xx — erro nosso; pode haver retry idempotente em GET

Perguntas frequentes

Como autentico?

Header Authorization: Bearer SEU_API_KEY. Gere a key em Configurações → API Keys.

Tem rate limit?

1.000 requisições/minuto por API key. Acima disso, retorno 429 com header Retry-After.

API tem SDK oficial?

Não no momento. A API é REST simples; qualquer client HTTP funciona. SDK Node está no roadmap.

Como recebo eventos sem fazer pull?

Use webhooks (veja /docs/webhooks). A API é para leitura sob demanda e operações de configuração.

Pronto para testar no seu vídeo?

Plano grátis sem cartão. Hospede um vídeo, embede no seu site e veja a retenção em minutos. Player sem marca a partir do Pro.