Busca

Busca textual (BM25) ou híbrida (BM25 + kNN e5 + rerank)

Busca em ~62M julgados. 50 resultados por página. Por padrão exclui decisões-stub (word_count < 10) e deduplica ementas quase idênticas.

modo=hibrido funde BM25 com kNN sobre embedding_e5 (RRF) e reordena o topo com cross-encoder; se o serviço de embeddings estiver indisponível, responde só BM25 com embedding_fallback: "bm25".

Correção ortográfica automática: sugestao traz a query corrigida quando aplicável.

Se q inteira for um número de processo — CNJ (0703333-12.2026.8.07.0009, com ou sem máscara) ou sigla de superior + número (REsp 1842871, HC 773186) — a busca vira filtro exato em numero_processo (busca_processo: "cnj" | "superior"); zero acertos recai na busca textual (número citado em ementa).

get/api/v1/busca

Request

  • Base URL: https://api.ragjur.ai
  • URL: https://api.ragjur.ai/api/v1/busca
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (authorization code, authorization URL https://mcp.ragjur.ai/oauth/authorize, token URL https://mcp.ragjur.ai/oauth/token, scopes: ragjur:read)

Query parameters

qstring required

Termos de busca (mín. 3 caracteres) ou número de processo (CNJ ou REsp 123).

fontestring

Código da base/tribunal (ver GET /filtros). Ex.: stj_integras, tst_jurisprudencia, tjsp_cjsg. Se omitido junto com tribunal, usa tst_jurisprudencia.

tribunalstring

Sigla do tribunal (ex.: STJ, TST, TJSP). Alternativa a fonte; abrange todas as bases do tribunal.

turmastring

Órgão julgador / turma / câmara.

relatorstring

Nome (ou parte) do relator/juiz.

classestring

Classe processual (ex.: REsp, AgInt, HC).

dataIniciostring date

Data inicial (YYYY-MM-DD) — julgamento ou publicação.

dataFimstring date

Data final (YYYY-MM-DD) — julgamento ou publicação.

data_julg_destring date

Data de julgamento inicial (YYYY-MM-DD) — range no campo data_julg_dt (futuro; até o backfill devolve 0 hits).

data_julg_atestring date

Data de julgamento final (YYYY-MM-DD) — range no campo data_julg_dt (futuro; até o backfill devolve 0 hits).

paginainteger

Página (1–200).

modo'hibrido'

hibrido ativa kNN + rerank.

dedup'true' | 'false'

false desliga a deduplicação semântica.

incluir_stubs'true' | 'false'

true inclui decisões-stub.

Response

Página de resultados

totalinteger required

Total de documentos que casam (antes da paginação)

paginainteger required
totalPaginasinteger required
relaxedboolean

Consulta relaxada (menos termos obrigatórios) por escassez de resultados

busca_processo'cnj' | 'superior'

q interpretada como número de processo — filtro exato em numero_processo

modo'hibrido'
rerankboolean
embedding_fallback'bm25'
incluir_stubsboolean
deduplicadosinteger
sugestaostring

Correção ortográfica sugerida/aplicada

Changes

No recorded changes to this operation across all 1 revision of this API.