VideoSpy API

Consultar a conta

GET /api/v1/me devolve o plano, o mês, a cota inclusa, as unidades usadas e quantas unidades formam um crédito. Esta rota não consome unidade.

GET/api/v1/me0 unidades

Use esta rota para saber se a chave está válida e quanto ainda cabe no mês antes de paginar o restante. Ela não envia os cabeçalhos x-videospy-*.

Chamada

curl https://videospy.com.br/api/v1/me \
  -H "Authorization: Bearer vsk_sua_chave"

{
  "tier": "ultra",
  "included": 5000,
  "used": 12,
  "unitsPerCredit": 20,
  "period": "2026-10"
}

Campo	Tipo	Significado
tier	texto	ultra, agency ou lifetime.
included	número	Unidades inclusas no mês. Vitalício devolve 0.
used	número	Unidades já registradas em period. Conta nova devolve 0.
unitsPerCredit	número	Sempre 20. Vinte unidades extras viram 1 crédito.
period	texto	Mês YYYY-MM em America/Sao_Paulo.

401, 403, 429, 500 e 503. Esta rota não devolve 402, porque não debita cota. A tabela está em Erros.