Créditos e preços

Começar grátis e testar a API

O plano Free custa R$ 0 e inclui R$ 50 em créditos de consulta, com ativação imediata e sem cartão. Crie uma conta em https://buscaprocessos.app.br/contratar?produto=api&plano=free para validar a integração. Os testes usam créditos do saldo gratuito; não é obrigatório comprar um pacote de R$ 150 para começar. O plano Free não inclui webhooks nem gestão de equipe. Confira os planos em https://buscaprocessos.app.br/api-integracoes#planos-api.

O plano Free usa o ambiente normal da API. Recargas pagas a partir de R$ 150 ampliam o saldo quando você precisar; não são obrigatórias para iniciar o teste.

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

O modelo por créditos permite começar por um fluxo específico e ampliar o volume conforme a automação prova valor. A operação decide quando aprofundar uma consulta, ativar monitoramento ou baixar conteúdo, mantendo custo e benefício alinhados ao caso de uso.

Previsibilidade para a operação

• acompanhe o saldo pelo painel, resposta e headers da API;
• consulte primeiro resumos e listagens para evitar aprofundamentos desnecessários;
• use monitoramentos somente para casos que precisam de acompanhamento contínuo;
• relacione cada execução ao requestId e ao extrato da conta;
• configure recarga automática quando a continuidade da automação for essencial.

📘 Produtividade com controle
O melhor fluxo não é o que faz mais chamadas, mas o que usa cada nível de informação no momento certo: descobrir, priorizar, aprofundar e monitorar.

Conceitos

Conceito	Descrição
Créditos	Saldo monetário (BRL) disponível para consumo da API
Recarga	Adição de saldo via PIX ou cartão
Uso	Débito registrado no extrato ao consumir endpoints
Assinatura	Plano 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)
• Endpoint GET /v1/conta/saldo

Consultar o saldo pela API

Use o mesmo x-api-key das consultas processuais. Esta operação é gratuita, não cria lançamento de consumo e funciona mesmo quando o saldo está zerado.

curl --request GET \
  --url 'https://api.buscaprocessos.app.br/v1/conta/saldo' \
  --header 'Accept: application/json' \
  --header 'x-api-key: bp_live_SUA_CHAVE'

Resposta:

{
  "data": {
    "credits": 672.26,
    "currency": "BRL",
    "accountStatus": "ACTIVE"
  },
  "meta": {
    "creditsRemaining": 672.26,
    "requestId": "req_saldo_exemplo",
    "searchLogId": null,
    "servedAt": "14:32:10"
  }
}

Use data.credits como saldo atual da conta. meta.creditsRemaining repete o valor para manter o mesmo contrato das outras respostas da API. O valor é expresso em créditos monetários, com currency: "BRL".

Como contratar o primeiro pacote

Você pode começar no plano Free. Para adicionar créditos pagos, escolha um pacote e conclua 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 após a consulta ser processada com sucesso no fluxo de negócio.

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, a API pode responder 404 com lista vazia sem consumir créditos.

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 Recarga.

Extrato

Em Extrato 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

Consulte em Preços da API os valores vigentes de cada operação, as regras de cobrança e as opções para otimizar o consumo. Condições comerciais e descontos podem variar conforme o plano contratado.

⚠ 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 e downloads
• Resumo por IA
• Intimações e históricos
• Monitoramentos e radares (inclui cobrança recorrente enquanto ativos)
• Publicações do STF, DJe do TSE/TREs, Mural Eletrônico e monitoramento dessas fontes
• Processos administrativos por NUP e monitoramento de novas movimentações
• Mandados de prisão no BNMP/CNJ

Rate limit e custo operacional

Além dos créditos, consultas pagas podem ter limite de requisições por IP. Em 429, respeite Retry-After e programe uma nova tentativa.

Playground

O Playground executa chamadas em produção e consome créditos da conta. Planeje os testes com saldo disponível.

Ativação e saldo inicial

Para ativar o uso da API, escolha um pacote em Planos da API e conclua a contratação em Contratar API. O saldo é atualizado após a confirmação do pagamento.

Próximos passos

• Primeiros passos
• Erros
• API Reference