VideoSpy API
Listar criadores
GET /api/v1/creators lista análises de criador concluídas por esta conta: plataforma, @, playbook, ids dos vídeos e datas. Custa 1 unidade.
GET/api/v1/creators1 unidade
Entram linhas com requested_by igual à conta da chave e status completed. Análise na fila, falha, perfil não encontrado ou pedida por outra conta fica de fora. A ordem é created_at decrescente.
Chamada
curl "https://videospy.com.br/api/v1/creators?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 criadores) 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 criador
| Campo | Tipo | Significado |
|---|---|---|
| id | uuid | Id da análise. |
| platform | texto | instagram, tiktok ou youtube. |
| handle | texto | Usuário, sem depender de um @ no começo. |
| playbook | objeto ou null | Playbook salvo ao concluir. Os campos estão na tabela seguinte. |
| video_ids | array de uuid | Vídeos dessa análise. Esses ids entram na base de GET /videos. |
| completed_at | data e hora ou null | Conclusão. |
| created_at | data e hora | Criação do pedido. Ordena a lista e o cursor. |
Campos de playbook
| Campo | Tipo | Significado |
|---|---|---|
| handle | texto | @ analisado. |
| platform | texto | instagram, tiktok ou youtube. |
| summary | texto | Resumo do perfil. |
| hookPatterns | array | Objetos com template, examples (textos) e type. |
| scriptStructure | array de texto | Passos típicos do roteiro. |
| formats | array | Objetos com formatId (texto ou null), name e howTheyUseIt. |
| toneAndLanguage | texto | Tom e linguagem. |
| pacing | texto | Ritmo. |
| ctas | array de texto | Chamadas para ação observadas. |
| topics | array de texto | Temas. |
| whyItWorks | texto | Leitura de por que o conjunto funciona. |
| contentKindMix | objeto | spoken e edit, contagens. |
| topVideos | array | Objetos com videoId, url, views (número ou null) e hook (texto ou null). |
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.