Guides
  1. Operação

Créditos e preços

A API BuscaProcessos cobra por uso com base em créditos da conta.

Conceitos

ConceitoDescrição
CréditosSaldo monetário (BRL) disponível para consumo da API
RecargaAdição de saldo via PIX ou cartão
UsoDébito registrado no extrato ao consumir endpoints
AssinaturaPlano opcional com créditos/descontos (área Assinatura)

Onde ver o saldo

  • Visão Geral
  • Uso
  • Extrato
  • Campo meta.creditsRemaining nas respostas da API
  • Header X-BuscaProcessos-Credits-Remaining (quando presente)

Como contratar o primeiro pacote

Para novos clientes, o caminho principal é a escolha do plano e o checkout:

  1. Abra Planos da API.
  2. Escolha um pacote (Essencial, Crescimento, Profissional ou Escala).
  3. Clique no CTA do card (ex.: Começar com R$ 150).
  4. Conclua em Contratar API com PIX ou cartão.

URLs de exemplo por valor:

  • https://buscaprocessos.app.br/contratar?produto=api&plano=150
  • https://buscaprocessos.app.br/contratar?produto=api&plano=300
  • https://buscaprocessos.app.br/contratar?produto=api&plano=500
  • https://buscaprocessos.app.br/contratar?produto=api&plano=1000

Como recarregar no painel

Se a conta já estiver ativa:

  1. Acesse Recarga.
  2. Escolha o valor (mínimo R$ 150,00).
  3. Presets na interface: 150, 300, 500, 1000.
  4. Selecione PIX ou cartão de crédito.
  5. Conclua o pagamento.
  6. Aguarde a confirmação; o saldo é atualizado no painel e no extrato.

Também existe recarga automática por cartão, com limiar de saldo baixo configurável na mesma tela.

O fluxo de pagamento usa o gateway Asaas.

Quando o crédito é debitado

O débito ocorre no handler autenticado após a consulta ser processada com sucesso no fluxo de negócio (via consumeApiCredits).

Consultas que falham por validação de entrada (documento ausente/inválido, chave inválida etc.) normalmente não chegam ao consumo.

Em listagem por CPF/CNPJ sem resultados, o handler atual responde 404 com lista vazia sem consumir créditos nesse caminho.

Saldo insuficiente

HTTP 403:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Créditos insuficientes para processar a consulta."
  }
}

Em alguns fluxos, a mensagem pode incluir saldo disponível e valor necessário.

Resolução: recarregue em /dashboard/topup.

Extrato

Em Extrato (/dashboard/billing) aparecem lançamentos como:

  • uso da API
  • recarga
  • recarga automática
  • renovação/expiração de assinatura
  • revisões de pagamento (quando aplicável)

Preços por endpoint

A tabela de preços de referência do produto está implementada em lib/api-pricing.ts e também é exibida na documentação do painel (/dashboard/docs#precos).

⚠

Importante
Valores podem ser negociados por conta, sofrer desconto de assinatura ou mudar com o tempo.
Use o painel e a comunicação comercial como fonte do valor vigente para o seu contrato.
Esta página não duplica a tabela completa para evitar divergência.

Categorias de cobrança (sem valores fixos aqui)

  • Consultas de processos e envolvidos
  • Movimentações, capa e atualizações
  • Documentos públicos, autos e downloads
  • Resumo por IA
  • Intimações e históricos
  • Monitoramentos e radares (inclui cobrança recorrente enquanto ativos)
  • Certificados e operações auxiliares (alguns status têm custo zero)

Rate limit e custo operacional

Além do crédito, rotas de consulta pagas podem aplicar rate limit por IP (perfil usado em várias rotas: 5 requisições / 60 segundos). Em 429, respeite Retry-After.

Playground

O Playground consome a API real e os créditos reais da conta. Não há sandbox de cobrança separado confirmado no código.

Contratação e saldo inicial

O fluxo comercial de ativação é contratar um pacote de créditos (a partir de R$ 150).
O saldo passa a refletir a recarga após a confirmação do pagamento no checkout.

Não documente o caminho /api-integracoes/cadastrar como onboarding principal: essa rota redireciona para o contato comercial.

Próximos passos