API Pública do DataJud (CNJ) Consulta por CPF ou CNPJ? Limitações Técnicas e Como Resolver

Quase todo time de engenharia que recebe a missão de construir um módulo de onboarding, crédito, compliance ou gestão jurídica começa pela mesma pesquisa: "API gratuita do DataJud CNJ para consultar processos por CPF e CNPJ". Poucas horas depois de ler a documentação e testar as primeiras queries em Elasticsearch DSL, surgem quatro bloqueios arquiteturais que mudam o cronograma do projeto.

Neste guia técnico mostramos exatamente o que a API pública do DataJud entrega, por que ela não resolve sozinha a descoberta por documento e como combinar padrões oficiais do CNJ com a alternativa complementar da API do BuscaProcessos.

1. Como funciona a API pública do DataJud na prática

A Base Nacional de Dados do Poder Judiciário (DataJud) consolida metadados remetidos pelos tribunais brasileiros para fins de estatística judiciária, políticas públicas (como o painel Justiça em Números) e padronização das Tabelas Processuais Unificadas (TPU).

Tecnicamente, a API pública expõe um alias Elasticsearch por tribunal (api_publica_tjsp, api_publica_trf1, api_publica_trt2, entre mais de 90 índices), autenticado por uma APIKey pública divulgada pelo próprio CNJ:

POST /api_publica_tjsp/_search
{
  "query": {
    "match": {
      "numeroProcesso": "00000000020248260100"
    }
  }
}

Quando você já possui o número único CNJ e sabe para qual índice rotear a chamada (extraindo os dígitos J.TR do número do processo), o retorno traz classe, códigos de assuntos TPU, órgão julgador e histórico de códigos de movimentos.

2. As 5 limitações que travam produtos de crédito, compliance e legaltechs

Se o caso de uso do seu software vai além de estatística agregada, esbarrará rapidamente nestes limites estruturais:

Por que o CPF não aparece no DataJud público?

A omissão de nomes e CPFs na API aberta do DataJud decorre do escopo estatístico daquele endpoint específico — e não de uma proibição legal à publicidade processual. Nos portais dos próprios tribunais (PJe, e-SAJ, eproc e Projudi), a consulta pública segue regida pelo art. 93, IX, da Constituição Federal e pela Resolução CNJ nº 121/2010, ressalvados os casos de segredo de justiça.

Além disso, como o DataJud depende de cargas periódicas enviadas pelos tribunais, uma ação recém-distribuída ou uma decisão urgente publicada hoje pode levar dias para refletir no índice estatístico, ou apresentar divergência quando o sistema de origem do tribunal passa por manutenção (algo que você pode acompanhar ao vivo no monitor de status dos 57 tribunais).

3. Arquitetura recomendada: descoberta + enriquecimento seletivo

Em vez de construir e manter dezenas de scrapers sujeitos a bloqueios, quebras de layout e desafios de captcha em 27 TJs, 24 TRTs e 6 TRFs, engenheiros adotam uma arquitetura enxuta em duas etapas sobre a API de integração do BuscaProcessos:

1. Camada de descoberta (GET /v1/processos): envie o CPF ou CNPJ sanitizado no backend. Se você só precisa checar tribunais específicos (por exemplo, TJSP e TRT2), passe o filtro de tribunais e pague apenas R$ 0,25 por tribunal que retornar resultado (ou R$ 2,00 na busca nacional até 200 processos).
2. Validação e roteamento CNJ: valide localmente o dígito verificador do número CNJ (veja nosso algoritmo de validação CNJ em Python e JavaScript) para evitar chamadas desnecessárias com números digitados incorretamente pelo usuário.
3. Aprofundamento sob demanda (R$ 0,12 a R$ 0,25): chame GET /v1/processos/cnj/{cnj} apenas para os processos que passarem pela sua regra de negócio (por exemplo, ações distribuídas nos últimos 5 anos ou de classes executivas/trabalhistas), adicionando GET /v1/mandados (R$ 0,25) quando a política de KYC exigir conferência no BNMP.

4. Exemplo rápido de migração para REST/JSON

Enquanto no DataJud seria necessário montar queries Elasticsearch DSL para dezenas de aliases sem obter as partes, na API do BuscaProcessos uma única chamada HTTP resolve a triagem inicial:

curl -sS "https://api.buscaprocessos.app.br/v1/processos?cpf_cnpj=${TEST_DOCUMENT}" \
  -H "x-api-key: ${BUSCAPROCESSOS_API_KEY}" \
  -H "Accept: application/json"

Caso algum tribunal exija varredura assíncrona em tempo real, a API responde HTTP 202 Accepted com Location e Retry-After — e o polling de acompanhamento não debita saldo adicional. Confira o código completo de produção no nosso tutorial de integração com Python e Node.js ou veja como plugar esse fluxo sem código em automação jurídica com n8n e Make.

Conclusão: qual escolher?

• Use a API pública do DataJud se você constrói estudos acadêmicos, jurimetria agregada por vara/assunto ou validação estatística em que já possui uma lista fechada de números CNJ e não precisa de partes, documentos ou baixa latência.
• Use a API Jurídica pré-paga sem mensalidade do BuscaProcessos quando seu produto, motor de risco ou escritório precisa descobrir processos por CPF/CNPJ, identificar autor e réu, ler resumos por IA, capturar o DJEN e Diários de Justiça ou conectar agentes autônomos via Servidor MCP Jurídico.