VideoSpy API
Listar formatos
GET /api/v1/formats lista formatos virais publicados: título, descrição, estrutura, template de hook, exemplos e dicas. Custa 1 unidade.
GET/api/v1/formats1 unidade
A lista é o catálogo com status published, igual para toda chave autenticada. Rascunho não entra. A ordem é created_at decrescente. Capa, categoria, dificuldade e URLs de referência ficam no app.
Chamada
curl "https://videospy.com.br/api/v1/formats?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 formatos) 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 formato
| Campo | Tipo | Significado |
|---|---|---|
| id | texto | Slug, por exemplo pergunta-confrontadora. |
| title | texto | Nome do formato. |
| description | texto | Explicação. |
| structure | array de texto | Passos da estrutura. |
| hook_template | texto | Molde do hook. |
| hook_examples | array de texto | Exemplos de abertura. |
| tips | array de texto | Dicas de adaptação. |
| 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.