Pular para o conteúdo principal

Cobertura de Tribunais (Integrador)

A API do BuscaProcessos disponibiliza um catálogo oficial com todos os 92 tribunais do Poder Judiciário Brasileiro. Com o endpoint GET /v1/integrador, você pode validar programaticamente nossa cobertura de integração, descobrir quais tribunais estão prontos para consulta/scraping (enable: true) e quais sistemas operam em cada tribunal (como e-SAJ, PJe, eproc ou Projudi).

Operação sem custo: o endpoint GET /v1/integrador não consome créditos da sua conta. Ele foi concebido para que o seu produto ou integração faça checagens de disponibilidade antes de disparar consultas pagas.

O que a API traz​

Cada requisição retorna um resumo consolidado (summary), os filtros aplicados e a listagem de tribunais:

  1. summary:
    • total: quantidade total de tribunais do judiciário (92).
    • habilitados: número de tribunais ativos na plataforma (61 tribunais).
    • desabilitados: tribunais com cobertura futura ou não aplicáveis para processos cíveis/trabalhistas/comuns (31 tribunais, como TREs e STM).
    • percentualCobertura: taxa de cobertura nacional (ex.: 66.3%).
  2. tribunais:
    • sigla: sigla oficial do tribunal (ex.: TJSP, TRF3, TRT2, STJ).
    • nome: nome completo do tribunal (ex.: Tribunal de Justiça do Estado de São Paulo).
    • segmento: esfera do judiciário (Estadual, Federal, Trabalhista, Superior, Militar, Eleitoral).
    • uf: unidade federativa da sede (SP, DF, RJ, etc.).
    • enable / enabled: booleano (true se o tribunal está ativo para scraping/consulta; false caso contrário).
    • sistemas: lista de sistemas processuais identificados no tribunal (ex.: ["e-SAJ", "eproc"], ["PJe-JT"]).

Endpoint​

GET https://api.buscaprocessos.app.br/v1/integrador

Autenticação​

Envie sua API Key no cabeçalho:

x-api-key: SUA_CHAVE_API

ou via Bearer token:

Authorization: Bearer SUA_CHAVE_API

Parâmetros de Consulta (Query Params)​

ParâmetroTipoDescriçãoExemplo
enablebooleanFiltra por status de integração: true (apenas tribunais ativos) ou false (inativos).?enable=true
tribunaisstringLista de siglas separadas por vírgula para consultar tribunais específicos.?tribunais=TJSP,TRF3,TRT2
segmentostringFiltra por ramo (Estadual, Federal, Trabalhista, Superior, Militar, Eleitoral).?segmento=Federal
ufstringFiltra pela UF da jurisdição.?uf=SP
sistemastringFiltra por tipo de sistema (ex.: pje, eproc, esaj).?sistema=eproc

Exemplos de Chamada​

cURL​

curl -X GET "https://api.buscaprocessos.app.br/v1/integrador?enable=true" \
  -H "x-api-key: SUA_API_KEY"

Node.js / TypeScript​

const response = await fetch("https://api.buscaprocessos.app.br/v1/integrador?enable=true", {
  headers: {
    "x-api-key": process.env.BUSCAPROCESSOS_API_KEY!,
  },
});

const { data } = await response.json();
console.log(`Tribunais cobertos: ${data.summary.habilitados} de ${data.summary.total}`);

for (const tribunal of data.tribunais) {
  console.log(`${tribunal.sigla} (${tribunal.segmento}) - Sistemas: ${tribunal.sistemas.join(", ")}`);
}

Python​

import os
import requests

response = requests.get(
    "https://api.buscaprocessos.app.br/v1/integrador?enable=true",
    headers={"x-api-key": os.environ["BUSCAPROCESSOS_API_KEY"]}
)

data = response.json()["data"]
print(f"Cobertura: {data['summary']['percentualCobertura']}")

Exemplo de Resposta​

{
  "data": {
    "summary": {
      "total": 92,
      "habilitados": 61,
      "desabilitados": 31,
      "percentualCobertura": "66.3%"
    },
    "filtros": {
      "enable": true,
      "segmento": null,
      "uf": null,
      "tribunais": null,
      "sistema": null
    },
    "tribunais": [
      {
        "sigla": "STF",
        "nome": "Supremo Tribunal Federal",
        "segmento": "Superior",
        "uf": "DF",
        "enable": true,
        "enabled": true,
        "sistemas": ["STF Digital"]
      },
      {
        "sigla": "TJSP",
        "nome": "Tribunal de Justiça do Estado de São Paulo",
        "segmento": "Estadual",
        "uf": "SP",
        "enable": true,
        "enabled": true,
        "sistemas": ["e-SAJ", "eproc"]
      },
      {
        "sigla": "TRF3",
        "nome": "Tribunal Regional Federal da 3ª Região",
        "segmento": "Federal",
        "uf": "SP",
        "enable": true,
        "enabled": true,
        "sistemas": ["PJe"]
      },
      {
        "sigla": "TRT2",
        "nome": "Tribunal Regional do Trabalho da 2ª Região",
        "segmento": "Trabalhista",
        "uf": "SP",
        "enable": true,
        "enabled": true,
        "sistemas": ["PJe-JT"]
      }
    ],
    "total": 61
  },
  "meta": {
    "creditsRemaining": 150.0,
    "requestId": "mugzetqx-c8515j",
    "searchLogId": "75264930-81f8-4b5d-8a37-6df7f480b745",
    "servedAt": "10:13:37"
  }
}

Endpoints Complementares​

  • GET /v1/sistemas: lista detalhada de cada sistema operacional por tribunal com requisitos de certificado digital e 2FA/captcha (mantido para compatibilidade também em /v1/tribunais/sistemas).