VideoSpy API
Listar vídeos
GET /api/v1/videos lista vídeos ligados às ideias da conta ou às análises de criador concluídas. No máximo 500 vídeos. Custa 1 unidade. A transcrição sai em GET /videos/:id.
GET/api/v1/videos1 unidade
A rota monta o conjunto de ids da conta e consulta no máximo os 500 primeiros. Acima disso, o restante não entra nesta lista. Sem nenhum id, data vem vazio. A ordem é published_at decrescente. O objeto desta lista não traz transcrição.
Chamada
curl "https://videospy.com.br/api/v1/videos?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 vídeos) 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 vídeo
| Campo | Tipo | Significado |
|---|---|---|
| id | uuid | Id usado em GET /videos/:id. |
| platform | texto | Origem do vídeo. Os valores usados no produto são instagram, tiktok e youtube. |
| canonical_url | texto | URL canônica do vídeo. |
| caption | texto ou null | Legenda. |
| published_at | data e hora ou null | Publicação. É a data da ordenação e do cursor. |
| views_current | número ou null | Visualizações conhecidas. |
| updated_at | data e hora | Última atualização do registro do vídeo. |
Para transcrição, hook e resumo, chame GET /videos/:id com o id desta lista.
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.