Pular para o conteúdo principal

Buscar por termo

GET 
/v1/busca/termo

Descobre pessoas, empresas e publicações judiciais por texto mesmo sem CNJ prévio. Sem período, consulta o índice local. Com ano_publicacao ou data_publicacao_inicio/data_publicacao_fim e qo=t ou qo=d, consulta comunicações oficiais no período e pode aplicar tribunal. Para q=precatório, ano_orcamentario ou ano_orcamentario_inicio/fim ativa registros orçamentários oficiais e permite filtrar tribunal, ente devedor, UF expedidora e faixa de valor. Correspondências com publicações incluem nível de confiança; ano orçamentário não confirma data de pagamento, e a base orçamentária não identifica diretamente o beneficiário. Confira mode, period, filters, quality, capabilities, totalExact, warnings, partial e cacheHit em meta.search. Cada requisição concluída, inclusive página adicional, pode gerar cobrança.

Valor para a operação: transforma pesquisa aberta em dados estruturados que podem alimentar descoberta, triagem e jornadas dentro do seu produto.

Autenticação e resposta: envie a chave em x-api-key ou Authorization: Bearer. Os exemplos mostram uma resposta típica; campos adicionais podem aparecer conforme o tipo de consulta. meta pode conter creditsCharged, creditsRemaining, requestId e searchLogId. Trate erros pelo status HTTP e por error.code.

SLA e HTTP 202: a API reserva uma janela total de até 30 segundos para responder. Quando uma consulta elegível não termina com segurança nessa janela, o trabalho continua no servidor e a resposta é HTTP 202, sem débito adicional naquele estado pendente. Siga o header Location ou data.statusUrl com a mesma API key; Retry-After, pollAfterSeconds, pollAfterMs e nextPollAt informam quando tentar novamente. Pare o polling quando receber um status diferente de 202. A URL de status reproduz a resposta final sem executar nem cobrar a operação novamente.

Requisição​

Responses​

Resposta da operação.