VideoSpy API

Listar ideias

GET /api/v1/ideas lista os cards do quadro da conta: título, roteiro, categoria, vídeo ligado, links, prazo e datas. Custa 1 unidade.

GET/api/v1/ideas1 unidade

A lista sai dos quadros cujo user_id é o da chave. Conta sem quadro recebe data vazio e nextCursor null. A ordem é created_at decrescente.

Chamada

curl "https://videospy.com.br/api/v1/ideas?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 ideias) 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 ideia

Campo	Tipo	Significado
id	uuid	Id do card.
title	texto	Título.
script	texto	Roteiro. Pode vir vazio.
category	texto	Texto salvo no quadro. O app grava uma lista JSON, como ["roteiro","gancho"], ou nomes separados por vírgula.
video_id	uuid ou null	Vídeo ligado ao card. Esse id entra na base de GET /videos.
links	array	JSON livre. O app grava objetos com url e, quando existe, label.
due_date	data ou null	Prazo em YYYY-MM-DD.
created_at	data e hora	Criação, usada na ordenação e no cursor.
updated_at	data e hora	Última alteração do card.

Item de data

{
  "id": "3f2a1c0e-4b5d-4e6f-8a9b-0c1d2e3f4a5b",
  "title": "Pergunta de R$ 300 mil",
  "script": "Abre com a pergunta e mostra a vistoria.",
  "category": "[\"roteiro\"]",
  "video_id": "8c1d2e3f-4a5b-4c6d-8e7f-9012345678ab",
  "links": [{ "url": "https://www.instagram.com/reel/exemplo", "label": "referência" }],
  "due_date": "2026-10-20",
  "created_at": "2026-10-01T15:04:05.000Z",
  "updated_at": "2026-10-02T11:00:00.000Z"
}

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.