VideoSpy API
Cota e limites
Ultra inclui 5.000 unidades por mês, Agência 20.000 e Vitalício começa em zero. Depois da cota, 20 unidades custam 1 crédito. Cada chave aceita 60 requisições por minuto.
Unidades por rota
| Rota | Unidades |
|---|---|
| GET /api/v1/me | 0 |
| GET /api/v1/ideas | 1 |
| GET /api/v1/videos | 1 |
| GET /api/v1/videos/:id | 2 |
| GET /api/v1/creators | 1 |
| GET /api/v1/formats | 1 |
| GET /api/v1/hooks | 1 |
A unidade é debitada depois que a chave e o plano passam, e antes da leitura. Em GET /videos/:id, o 404 de vídeo fora da base também conta 2. Um 401, 403 ou 429 não conta.
Cota inclusa
| Plano | included | Condição |
|---|---|---|
| ultra | 5000 | subscription_status active e sem acesso de Agência por cima. |
| agency | 20000 | agency_access ligado na conta. Vale mesmo se o tier do plano for outro. |
| lifetime | 0 | subscription_status active. Toda unidade entra no uso pago. |
| Pro e demais | — | A chave responde 403. A API não está inclusa. |
Uso depois da cota
O que passa de included acumula no mês. A cada 20 unidades acumuladas, a API debita 1 crédito de IA, o mesmo saldo do app, a R$ 0,40. O resto que não fecha 20 fica para a próxima chamada. Se o saldo não cobre o débito, a resposta é 402 e a unidade não entra no used.
{
"error": "Cota inclusa esgotada e sem créditos para o uso extra.",
"used": 5000,
"included": 5000,
"balance": 0
}Cabeçalhos nas rotas que consomem
| Cabeçalho | Significado |
|---|---|
| x-videospy-used | Unidades usadas no mês depois desta chamada. |
| x-videospy-included | Cota inclusa do plano. |
| x-videospy-balance | Saldo de créditos de IA depois desta chamada. |
60 requisições por minuto
O limite é por chave, em janela deslizante de 60 segundos quando o Redis de rate limit está configurado. Sem Redis, a contagem fica na instância. Acima do teto a resposta é 429, com a mensagem Limite de 60 requisições por minuto nesta chave. Essa resposta não consome unidade.
Uma sincronização de hora em hora das rotas de 1 unidade cabe nas 5.000 do Ultra. Um puxão de dezenas de milhares de chamadas atravessa a cota e passa a debitar crédito.