VideoSpy API

Introdução à API

Base https://videospy.com.br/api/v1, JSON, somente GET. A chave Bearer lê ideias, vídeos da conta, criadores já analisados, formatos publicados e hooks enriquecidos.

A API leva para outro sistema o que a conta já tem no VideoSpy: o quadro de ideias, os vídeos ligados a essas ideias ou a uma análise de criador concluída, a transcrição e a análise desses vídeos, e os catálogos publicados de formatos e hooks.

Rotas

RotaUnidadesO que devolve
GET /me0Plano, mês, cota inclusa e unidades já usadas.
GET /ideas1Cards do quadro da conta.
GET /videos1Vídeos da base da conta, até 500.
GET /videos/:id2Um vídeo com transcrição e análise, se estiver na base.
GET /creators1Análises de criador concluídas por esta conta.
GET /formats1Formatos virais com status publicado.
GET /hooks1Hooks com enriquecimento concluído.

Criar, revogar e nomear chaves acontece em Configurações, aba API. A API pública não cria chave, não grava ideia e não dispara webhook.

Primeira chamada

Conferir plano e cota
curl https://videospy.com.br/api/v1/me \
  -H "Authorization: Bearer vsk_sua_chave"
200
{
  "tier": "ultra",
  "included": 5000,
  "used": 12,
  "unitsPerCredit": 20,
  "period": "2026-10"
}

tier é ultra, agency ou lifetime. period é o mês calendário em America/Sao_Paulo, no formato YYYY-MM. included é a cota desse plano. used é o que já entrou no mês. unitsPerCredit é sempre 20.

Paginação

As listas usam limit e cursor. A resposta traz data e nextCursor. Envie o nextCursor recebido no parâmetro cursor da chamada seguinte. Quando nextCursor é null, a página atual é a última.

Segunda página de ideias
curl "https://videospy.com.br/api/v1/ideas?limit=20&cursor=CURSOR_DA_RESPOSTA" \
  -H "Authorization: Bearer vsk_sua_chave"
  • limit padrão 20, mínimo 1, máximo 50.
  • Um cursor ausente ou que não decodifica abre a primeira página.
  • O cursor é opaco. Copie o valor. Não monte o texto.

Cabeçalhos de uso

Rotas que consomem unidade devolvem x-videospy-used, x-videospy-included e x-videospy-balance. GET /me não consome unidade e não envia esses cabeçalhos. O corpo de /me já traz used e included.

Continuar por aqui