Escavador API: guia da v2, autenticação, créditos e alternativas

A Escavador API (comercializada como Escavador Business API) é uma API REST para consultar e monitorar processos judiciais no Brasil. Com ela você busca processos por número CNJ, por nome ou CPF/CNPJ de uma parte e pela OAB de um advogado, pede atualização direto nos tribunais, baixa documentos e recebe eventos por callback. A autenticação é por token Bearer e a cobrança é por uso, com créditos pré-pagos ou contrato pós-pago.

Abaixo está o que você precisa saber antes de integrar: as duas versões, as rotas principais, como funciona o saldo, os limites e as alternativas, inclusive a de construir a sua própria API jurídica.

Escavador API v1 e v2: qual usar

Segundo a documentação oficial, a API tem duas versões ativas, com preços diferentes:

• V1 (`https://api.escavador.com/api/v1`): Busca e monitoramento de processos, pessoas e empresas, além de consulta e monitoramento em diários oficiais.
• V2 (`https://api.escavador.com/api/v2`): Focada em processos, com mais informação estruturada e detalhada. É a versão que recebe as novidades, como resumo por IA, autos com certificado digital e estatísticas de envolvidos.

Para um sistema de acompanhamento processual, a v2 costuma ser o ponto de partida. A v1 ainda é relevante se você precisa de monitoramento de diários oficiais por termo no formato que ela oferece.

Como funciona a autenticação da Escavador API

O acesso usa um Personal Access Token (PAT). Você cria uma conta, gera o token no painel da API e ele é exibido uma única vez. Todas as requisições enviam o token no cabeçalho Authorization com o prefixo Bearer. A documentação é explícita: o PAT é para comunicação servidor a servidor e não deve ser exposto no frontend.

curl -X GET "https://api.escavador.com/api/v2/processos/numero_cnj/NUMERO_CNJ" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json"

O limite documentado é de 500 requisições por minuto. Há também um SDK oficial em Python, com suporte às duas versões, publicado no GitHub do Escavador.

Principais rotas da Escavador API v2

Base própria x atualização no tribunal

Um detalhe que muda a arquitetura da sua integração: as rotas de consulta devolvem dados da base do Escavador. Se você precisa do estado mais recente, chama a rota de solicitar atualização, espera o status de sucesso (consultando o status ou recebendo um callback) e só então lê de novo. Para autos restritos, a atualização pode usar um certificado digital cadastrado na plataforma, e o tribunal pode exigir autenticação multifator.

Busca por CPF e homônimos

A própria documentação alerta que a busca por CPF pode não retornar processos quando o tribunal não registra o CPF da parte, e que nomes têm homônimos. A recomendação é buscar pelo nome e filtrar por estado. Leve isso em conta antes de prometer ao cliente uma busca completa por CPF.

Monitoramento e callbacks na Escavador API

Ao criar um monitoramento de processo, ele começa como pendente e passa para encontrado quando o robô do Escavador localiza o processo no tribunal. Se não encontrar, o status vira nao_encontrado e, segundo a documentação, não há cobrança. No monitoramento de novos processos, o termo é procurado nas capas e nos envolvidos, com um limite padrão de 10.000 aparições por mês que pode ser ajustado.

Os eventos chegam por callback (webhook) em uma URL que você configura no painel. Para validar a origem, você gera um token de segurança e confere se ele chega no cabeçalho Authorization. As boas práticas da documentação valem para qualquer webhook: endpoint só em HTTPS, processamento idempotente, resposta rápida e trabalho pesado em fila.

Escavador API: preço e cobrança por créditos

Os preços da API não ficam em uma página pública aberta: a tabela por rota aparece dentro do painel da API, após o cadastro. O que é público, na central de ajuda da API (consultado em setembro de 2026):

• Cada rota tem seu custo: O custo da requisição, em centavos, vem no cabeçalho Creditos-Utilizados de cada resposta.
• Pré-pago ou pós-pago: No pré-pago, você compra créditos no painel respeitando um valor mínimo de recarga. No pós-pago, as condições ficam em contrato. Segundo a página de compra de créditos, os créditos têm validade padrão de 90 dias.
• Consultas volumosas cobradas em blocos: Nas buscas por pessoa ou OAB da v2, o valor base cobre os primeiros 200 processos e cada bloco adicional de 200 tem um valor complementar. Consultas idênticas em até 24 horas têm preço reduzido. O artigo de suporte ilustra com R$ 4,50 pela consulta base e R$ 0,05 por bloco extra, mas confirme os valores vigentes no painel.
• Volume alto: O Escavador informa que tem valores e pacotes especiais para grande volume, negociados com o time comercial.

O modelo por uso é ótimo para começar: você paga pouco enquanto testa. O ponto de atenção aparece quando o produto cresce, porque cada novo escritório, processo monitorado ou atualização solicitada vira custo variável.

Alternativas à Escavador API

Antes de fechar com qualquer fornecedor, compare cobertura, modelo de cobrança e forma de entrega dos eventos. O comparativo completo de fontes, inclusive as oficiais, está no guia de API de processos judiciais.

Fontes: documentação da Judit, planos da Judit, autenticação da Codilo, APIs do Jusbrasil Soluções e wiki do DataJud.

Sobre o DataJud, vale o aviso: ele é gratuito e cobre todos os ramos da Justiça, mas não traz dados de partes e o Termo de Uso restringe o uso a fins não comerciais, proibindo vender ou explorar comercialmente informação derivada dele. Para produto pago, trate-o como fonte de estudo e validação, não como matéria-prima de revenda.

Boas práticas para integrar a Escavador API

Se você decidir usar a Escavador API, alguns cuidados evitam surpresa na fatura e problemas de segurança:

• Registre o custo de cada chamada: Grave o valor do cabeçalho Creditos-Utilizados junto com o cliente e a rota. Assim você sabe quanto cada escritório custa e consegue precificar o seu produto com margem.
• Guarde os dados na sua base: Evite repetir a mesma consulta a cada tela aberta. Consulte uma vez, armazene e só peça atualização quando fizer sentido para o negócio.
• Prefira callbacks a polling: Em atualizações assíncronas, esperar o callback economiza requisições e respeita o limite de 500 por minuto.
• Proteja o token: Mantenha o PAT em variável de ambiente ou cofre de segredos, nunca no frontend ou no repositório, e gere tokens separados por ambiente.
• Cuide da LGPD: Os retornos trazem nomes, CPFs e dados de partes. Restrinja o acesso por cliente e registre quem consultou o quê.

Vale a pena criar sua própria API jurídica em vez da Escavador API?

Se você precisa de busca nacional por nome ou CPF, com base histórica pronta, a Escavador API entrega isso de um jeito que levaria muito tempo para replicar. Mas boa parte do que um escritório de advocacia paga no dia a dia é mais simples: acompanhar os processos da própria carteira e ser avisado quando algo muda. Esse caso de uso cabe em um robô próprio, e aí o custo deixa de crescer a cada consulta.

Seja honesto na conta, porém: API própria exige alguém cuidando de quebras quando um tribunal muda o sistema, monitorando filas e respondendo a incidentes. Muitos projetos acabam híbridos, com robô próprio para o monitoramento recorrente e um fornecedor pago para buscas pontuais.

Como montar uma alternativa própria à Escavador API

A arquitetura espelha o que você viu nas rotas do Escavador: coleta, base própria, atualização e eventos.

• Fontes: Consultas públicas dos tribunais, a API pública de comunicações do Diário de Justiça Eletrônico Nacional (DJEN), o DataJud do CNJ dentro do termo de uso e, com credenciais do escritório, integrações oficiais como o MNI do PJe.
• Robô coletor: Agendamento por processo, limite de requisições por fonte, tentativas com espera e registro de erros. Captcha e bloqueios são respeitados, não contornados.
• Normalização e banco: Um modelo único de processo e movimentação, com histórico completo. É o equivalente à "base própria" do fornecedor.
• Detecção de mudanças: Compara a coleta nova com a anterior e gera eventos só do que mudou.
• Webhooks e alertas: Os mesmos cuidados que o Escavador recomenda: HTTPS, assinatura ou token de validação, idempotência e fila.
• API: Autenticação por token por cliente, isolamento dos dados de cada escritório e registro de acesso, porque a LGPD se aplica a dados processuais.

Se o seu cliente atua em um tribunal com sistema próprio, veja também os guias de API do TJSP e API da OAB, útil para quem quer monitorar por advogado.

No workshop de robô de monitoramento processual você percorre esse caminho de ponta a ponta: onde buscar processos atualizados, o que importa para o escritório, desenvolvimento, riscos, ferramentas e a construção do robô, com o método que roda em produção no Mattozo & Ribeiro Advocacia.