API REST

Limites e erros

Os limites valem para a conta inteira e são os mesmos na API e no MCP.

Limites e quota

Os limites são por conta, não por chave: criar mais chaves não aumenta a quota. Cada item de uma lista conta como um registro; um perfil, uma série histórica ou uma captura de flow contam um.

Requisições por minuto	60
Requisições por dia	1.000
Registros por dia	2.000
Registros por mês	15.000
Itens por chamada	25
Offset máximo	100
Histórico de MRR	90 dias, pontos semanais
URLs de screenshots	expiram em 60 minutos
Chaves ativas	3 por conta

Headers de resposta

X-RateLimit-Remaining: requisições restantes no minuto atual
X-Noctral-Records: registros consumidos por esta chamada
X-Noctral-Records-Remaining-Day: registros restantes hoje
X-Noctral-Records-Remaining-Month: registros restantes no mês
Retry-After: segundos até poder tentar de novo (em respostas 429)

Erros

Erros vêm como { "error": { "code", "message", "docs_url" } }. A mensagem é escrita para ser lida por uma pessoa ou por um agente.

401	`UNAUTHORIZED`	Chave ausente.
401	`INVALID_KEY`	Chave ou token inválido, expirado ou revogado.
403	`PRO_REQUIRED`	A conta não tem o plano Pro ativo.
403	`ACCESS_BLOCKED`	Acesso suspenso por uso fora dos termos.
400	`INVALID_PARAMETER`	Parâmetro inválido, desconhecido ou fora do limite.
404	`NOT_FOUND`	App, nicho, SaaS ou rota inexistente.
429	`RATE_LIMITED`	Limite por minuto atingido.
429	`DAILY_REQUESTS_EXHAUSTED`	Requisições do dia esgotadas.
429	`DAILY_RECORDS_EXHAUSTED`	Registros do dia esgotados.
429	`MONTHLY_RECORDS_EXHAUSTED`	Registros do mês esgotados.

Uso permitido

Use os dados para pesquisa, validação de ideias e decisões do seu próprio produto.
Não revenda, redistribua nem publique os dados em massa, e não use a API para montar uma base concorrente.
Não compartilhe chaves entre pessoas: o acesso é pessoal, como a conta.
MRR e downloads são estimativas do modelo da Noctral, arredondadas a dois dígitos significativos.

Termos de Uso