VideoSpy API
Listar hooks
GET /api/v1/hooks lista hooks com enriquecimento concluído: título em português, explicação, como adaptar, categoria e tags. Custa 1 unidade.
GET/api/v1/hooks1 unidade
Entram registros com enrich_status done. Pendente e falha ficam de fora. A ordem é created_at decrescente. Vídeo de exemplo, pôster e nome em inglês ficam no app.
Chamada
curl "https://videospy.com.br/api/v1/hooks?limit=20" \
-H "Authorization: Bearer vsk_sua_chave"Parâmetros
| Nome | Onde | Tipo | O que faz |
|---|---|---|---|
| limit | query | número | Itens por página. Padrão 20. O mínimo é 1 e o máximo é 50. Um valor que não é número vira 20. Acima de 50 vira 50. |
| cursor | query | texto | Valor de nextCursor da página anterior, enviado sem alteração. Ausente ou inválido abre a primeira página. |
Resposta 200
O corpo é um objeto com data (array de hooks) e nextCursor (texto ou null). null encerra a lista. A ordem é da data mais recente para a mais antiga, com id como desempate.
Campos de cada hook
| Campo | Tipo | Significado |
|---|---|---|
| id | uuid | Id do hook. |
| title_pt | texto ou null | Título em português. |
| explanation | texto ou null | O que o hook faz. |
| how_to_adapt | texto ou null | Como levar o hook para outro nicho. |
| category | texto ou null | Categoria do catálogo. |
| tags | array de texto | Tags. Pode vir vazio. |
| created_at | data e hora | Criação do registro. Ordena a lista e o cursor. |
Erros
| Status | Quando acontece |
|---|---|
| 401 | Header ausente, esquema diferente de Bearer, chave que não começa com vsk_, chave curta, hash desconhecido ou chave revogada. |
| 403 | Plano sem API. Entram Ultra e Vitalício com assinatura ativa, e conta com acesso de Agência. |
| 402 | Cota do mês esgotada e saldo de créditos insuficiente para o uso extra. O corpo traz used, included e balance. |
| 429 | Mais de 60 requisições na mesma chave dentro de um minuto. |
| 500 | Falha ao registrar o uso ou ao ler os dados. |
| 503 | A função de cota ainda não está ativa neste ambiente. |
O detalhe de cada status está em Erros. Cabeçalhos de uso saem em Cota e limites.