VideoSpy API
Recursos
De onde sai cada lista da API do VideoSpy: quadro da conta, vídeos ligados a ideias ou a criadores já analisados, formatos publicados e hooks enriquecidos.
Cada rota devolve um recorte fixo. A chave não escolhe permissão. O recorte abaixo é o que a conta pode ler.
| Recurso | Entra na resposta | Fica de fora |
|---|---|---|
| Ideias | Cards dos quadros desta conta. | Coluna, posição, anexos e responsável. |
| Vídeos | Vídeo ligado a uma ideia ou listado numa análise de criador concluída por esta conta. Até 500 ids. | O feed e o catálogo global do app. |
| Um vídeo | O vídeo acima, mais a linha de análise quando ela existe. | Vídeo de outra conta. A resposta é 404. |
| Criadores | Análise com status completed pedida por esta conta. | Fila, falha, perfil não encontrado e análise pedida por outra conta. |
| Formatos | Formato com status published. | Rascunho e campos de capa do app. |
| Hooks | Hook com enrich_status done. | Hook pendente ou com enriquecimento falho, e a mídia de origem. |
Base de vídeos da conta
Um vídeo entra na base quando o id está no campo video_id de um card seu, ou dentro de video_ids de uma análise de criador sua com status completed. GET /videos lista esses vídeos, no máximo 500. GET /videos/:id lê um deles e, se houver linha em video_analyses, devolve transcrição, idioma, resumo, hook e o motivo de ter funcionado.
Perguntas frequentes
A API lista o feed de vídeos acima da média?
O feed fica no app. Pela API, o vídeo aparece depois de ir para uma ideia sua ou para uma análise de criador concluída por você.