Hoje a cobrança chega à plataforma Croma. Sabemos que mudar a forma de cobrar gera perguntas, então esta entrada explica cada regra e cada número, sem letras miúdas. A ideia que guia tudo: você paga pelo que a API entrega, vê seu saldo a qualquer momento e nunca é pego de surpresa por um limite.
Se você já tem uma organização, não precisa fazer nada. Ela já está no plano Free, com créditos para este mês, e o seu console mostra o saldo a partir de hoje.
O que muda, em uma frase#
Antes, cada organização tinha um teto de 100 requisições por dia, igual para todos. Agora, cada organização tem um saldo mensal de créditos, e cada requisição consome créditos de acordo com o custo de atendê-la. O teto diário deixa de existir.
Como funcionam os créditos#
Dois tipos de requisição, um único saldo:
| Requisição | Créditos | O que é |
|---|---|---|
| Live | 10 | Um endpoint de dados por país ou global que consulta a fonte oficial no momento em que você o chama: processos judiciais, registros empresariais, veículos, antecedentes, busca na web, extração. |
| Datasets | 1 | Um endpoint que responde a partir das tabelas da Croma, atualizadas regularmente: contratações públicas, normas, diários oficiais, jurisprudência. O guia de cada um indica isso, e ele responde em milissegundos. |
A diferença de preço reflete a diferença de custo. Uma consulta live à fonte oficial tem um custo real a cada vez; um dataset já está pronto. Com o mesmo saldo, você escolhe a combinação que funciona para você: 500 consultas live, 5.000 consultas a datasets ou qualquer mistura entre as duas.
As regras, todas elas:
- Os créditos são renovados na data mensal do seu plano. Os que você não usar não se acumulam.
- Requisições em lote consomem por item: um lote de 10 consultas live consome 100 créditos.
- Uma requisição que falha não consome nada. Uma resposta vinda do cache consome o mesmo que uma nova.
- Consultar o status de um job assíncrono nunca consome créditos.
- Busca na web, extração e research mantêm seus limites por hora. Eles protegem as fontes, não o seu bolso.
Os planos#
Todos os planos incluem o catálogo completo, o servidor MCP e o console. A única diferença é quantos créditos você recebe por mês.
| Plano | Preço | Créditos por mês | Equivale a |
|---|---|---|---|
| Free | US$ 0 | 5.000 | 500 consultas live ou 5.000 consultas a datasets |
| Hobby | US$ 20 | 20.000 | 2.000 consultas live ou 20.000 consultas a datasets |
| Standard | US$ 99 | 100.000 | 10.000 consultas live ou 100.000 consultas a datasets |
| Contrato | Sob medida | O que combinarmos | Maior volume, faturamento sob medida ou condições próprias |
Nos planos pagos, cada 1.000 créditos custam um dólar. O Free não pede cartão. O upgrade vale na hora, com cobrança proporcional; o downgrade vale no fim do período; cancelar leva um clique no portal de cobrança. Os detalhes estão na página de preços.
O que você vê em cada resposta#
O seu código vê o mesmo número que você. Cada resposta da API traz o saldo nos cabeçalhos, em créditos:
X-RateLimit-Limit: 20000
X-RateLimit-Remaining: 19988
X-RateLimit-Reset: 2026-10-04T04:19:37.174Z
RateLimit-Policy: "credits";q=20000;w=2592000Quando o saldo acaba, a API responde 402 com uma mensagem que diz o que fazer, e volta a responder normalmente assim que você faz upgrade ou chega a renovação:
{
"error": {
"type": "billing_error",
"code": "plan_limit_reached",
"message": "Your plan has no credits left for this period. Upgrade at https://platform.usecroma.com/billing or wait until 2026-10-04T04:19:37.174Z."
}
}O código de erro e os cabeçalhos estão documentados em limites de requisições.
Avisos antes que algo aconteça#
Ninguém deveria descobrir um limite em produção. Por isso, os administradores da sua organização recebem um e-mail quando o consumo chega a 80% dos créditos do mês, e outro se eles acabarem. O e-mail diz quanto você já usou, quanto tem e quando o saldo é renovado, com o link direto para o seu console, para você decidir com calma.
O seu console#
Em platform.usecroma.com/billing você vê o seu plano, o seu saldo de créditos, a data de renovação e os planos disponíveis. Ali você faz upgrade pelo Stripe, gerencia a forma de pagamento, baixa faturas ou cancela. Só os administradores da organização podem mudar o plano; o resto da equipe vê os mesmos números.
Contratos#
Se o seu volume passa do Standard, se você precisa de faturamento sob medida ou prefere condições próprias, a gente conversa e formaliza tudo em um contrato com o seu próprio número de créditos por mês. Na API e no console, ele aparece exatamente como qualquer outro plano: mesmos cabeçalhos, mesmo saldo, mesmos avisos. Só muda quem envia a fatura.
Crescemos juntos#
Construímos este modelo com uma convicção: que cada centavo que você investe na Croma vire dados que servem a você, e que você consiga ver essa relação com clareza. Começar é grátis, crescer é proporcional e nenhuma decisão é tomada no escuro. Se algo aqui não faz sentido para você, ou se você tem um caso que estas regras não cobrem bem, fale com a gente. Ajustamos com prazer.