Todos os números, num lugar só

O teto por minuto conta toda requisição autenticada, numa janela móvel de 60 segundos — ela não zera na virada do relógio; drena conforme as chamadas antigas saem da janela. O teto por dia funciona igual, em 24 horas móveis, e conta só as requisições que consultam a fonte — leitura servida do acervo não gasta.

Nos planos com teto, toda resposta atendida traz os headers RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset referentes à janela por minuto — sua aplicação não precisa adivinhar quanto resta dela; o consumo do dia e do ciclo se consulta em GET /v1/usage, de custo zero. Estourar devolve 429 RATE_LIMITED com Retry-After e a janela que barrou em details.window.

async function comRetentativa(fazerChamada, maxTentativas = 3) {
  for (let tentativa = 0; tentativa < maxTentativas; tentativa += 1) {
    const resposta = await fazerChamada();
    if (resposta.status !== 429) return resposta;

    // O 429 já diz quando tentar de novo — respeite-o em vez de adivinhar.
    const espera =
      Number(resposta.headers.get("retry-after") ?? 2 ** tentativa * 2);
    await new Promise((r) => setTimeout(r, espera * 1000));
  }
  throw new Error("Limite de vazão persistiu após as retentativas.");
}

A cota de créditos vale pelo ciclo de cobrança: a franquia do plano mais os pacotes avulsos ativos, contra o consumido e os pedidos assíncronos ainda em andamento — um job aceito já comprometeu o crédito dele. Estourar devolve 402 QUOTA_EXCEEDED com o extrato no corpo — e o webhook QUOTA_LOW avisa antes, aos 80% da franquia. Operações de custo zero continuam funcionando com a cota esgotada.

Além da cota da conta, cada chave pode ter um teto diário de créditos próprio — janela móvel de 24 horas, configurável no portal (até 1.000.000). Ele limita o estrago de uma credencial isolada sem parar as outras; estourar devolve 402 API_KEY_DAILY_CAP_EXCEEDED e as operações de custo zero seguem passando. Para conexões de agente de IA, o portal sugere 200 créditos/dia — um agente em loop não gasta o mês numa tarde.

Vigílias de texto (a busca salva que o motor repete todo dia): até 50 por conta, em qualquer plano — a 51ª responde 409. Elas não consomem créditos.

Colheita de jurisprudência sob demanda: um pedido cobre até 92 dias de janela (mais que isso é 400 de validação) e vira fatias — um dia de um tribunal ocupa 2 fatias. Os tetos de fatia são 30 por pedido e 300 por conta por dia; o excedente desses tetos volta recortado na resposta (campo rejected), nunca como erro. Só a fatia nova cobra 1 crédito: o que o acervo compartilhado já tem entra de graça.

Consulta servida do acervo custa menos porque não vai à fonte. O que decide é o frescor do dado, e a janela é a do seu plano: Starter serve do acervo o processo consultado há menos de 24 horas; Pro, 6 horas; Business, 1 hora; Enterprise, 15 minutos. Processo mais velho que a janela, a consulta revalida na fonte e cobra o preço cheio. A mesma escada dispara a atualização da série de publicações de um processo — em segundo plano, sem segurar a resposta.

O outro lado da moeda, dito com todas as letras: plano com janela mais curta revalida com mais frequência, então paga o preço cheio mais vezes na mesma rotina de consulta. É a troca — dado mais fresco por crédito.

A tabela completa de custos por operação está na página principal da documentação.