Retorna o uso atual da cota da API para a empresa autenticada
Retorna o uso e os limites atuais da cota da empresa — uma entrada por janela de cota, como por minuto ou por dia. Todas as API keys da empresa compartilham essa cota. Use este endpoint para se auto-limitar antes de disparar requisições analíticas pesadas. Observações: - Quando uma métrica não tem limite, a resposta usa `limit: null` e `remaining: null` para você não dividir por zero. - Quando a empresa não tem cota, `quotas` é uma lista vazia. - Uma única chamada à API pode contar como mais de uma query contra `max_queries_per_minute`, então o contador `queries` pode subir mais rápido que a sua taxa real de requisições. A resposta inclui `queries.note` para sinalizar isso quando há um limite ativo. O `read_bytes` reflete o volume de dados efetivamente lido e é o sinal mais confiável para dimensionar o seu uso. - O próprio endpoint conta como 1 query contra `max_queries_per_minute`.
Authorization
apiToken apiVersion userAgent Acesse a aplicação e copie seu token de API, em seguida, defina o cabeçalho X-Api-Token com ele.
In: header
A versão da API a ser usada. As versões suportadas atualmente são:
- v1: A versão estável atual
Uma requisição sem este cabeçalho, ou com qualquer outro valor, é respondida pela borda com 404 e {"error_msg":"404 Route Not Found"}.
In: header
É obrigatório enviar um User-Agent não vazio identificando sua integração.
Requisições sem ele são rejeitadas na borda antes de chegar à API.
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/quota/usage"{ "quotas": [ { "interval_seconds": 60, "interval_starts_at": "2026-04-27T12:34:00Z", "interval_ends_at": "2026-04-27T12:35:00Z", "queries": { "used": 20, "limit": 60, "remaining": 40, "note": "a single API request may count as more than one query against this limit" }, "read_bytes": { "used": 92535478, "limit": null, "remaining": null } }, { "interval_seconds": 86400, "interval_starts_at": "2026-04-27T00:00:00Z", "interval_ends_at": "2026-04-28T00:00:00Z", "queries": { "used": 245, "limit": null, "remaining": null }, "read_bytes": { "used": 4500000000, "limit": 343597383680, "remaining": 339097383680 } } ]}Retorna o conjunto completo de métricas para até 2 players de um teste A/B POST
Retorna, em uma única resposta, o conjunto completo de métricas de analytics para até 2 players de um teste A/B: views, plays, finishes, clicks, conversões com receita em USD/BRL/EUR, engagement, pitch audience e pitch retention, além das taxas derivadas de play rate, conversion rate e receita por visitante (RPV). O `start_date` de cada item é opcional — quando ausente, usa como padrão o `started_at` do próprio player (da lista `players` do comparison group) e, se ele também estiver nulo, o `started_at` do teste A/B. Quando `end_date` é omitido, o resultado considera até o momento atual.
Primeiros passos
Gerencie vídeos, uploads, arquivos, testes A/B e domínios do VTurb via REST