Busca de tesis da SCJN em todo o acervo

POST /mx/scjn/tesis-search/v1 agora responde sobre todo o acervo da Suprema Corte de Justicia de la Nación: todas as tesis e jurisprudências que o Semanario Judicial de la Federación publicou desde 1911, mais de 300 mil, cada uma na íntegra, com o acervo completo e atualizado. A busca mantém os seus campos e ganha os que o browse havia estreado: instance, court, formation, published_from, published_to e updated_after. query passa a ser opcional, então uma consulta só com filtros funciona.

curl https://api.croma.run/mx/scjn/tesis-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "interés usurario",
    "court": "Primera Sala",
    "published_from": "2026-01-01"
  }'

Cada resultado é o registro completo, no mesmo formato da resposta de POST /mx/scjn/tesis/v1: o texto com as suas seções, os precedentes, a forma de integração e as datas de publicação e de obrigatoriedade. Os resultados chegam do mais recente para o mais antigo, as páginas aceitam até 50, e cada resposta traz as_of, que indica o quão atualizados estão os dados.

O que mudou na resposta#

• As entradas de results[] são registros completos. Saem os fragmentos snippets e o year de primeiro nível; o ano fica em location.year.
• Sai facets. Os valores dos filtros são lidos exatamente como aparecem nos resultados: instance, court, formation e subjects.
• A resposta ganha as_of e devolve os filtros aplicados.
• Com query, todas as palavras precisam aparecer na ementa ou no texto.

Browse fica obsoleto#

POST /mx/scjn/tesis-browse/v1 fazia o mesmo com outro nome. Ele está obsoleto desde 7 de setembro de 2026 e deixa de responder em 15 de dezembro de 2026. Até lá, continua funcionando igual, e cada resposta traz os cabeçalhos Deprecation e Sunset e um Link com rel="successor-version", como descreve a política de versionamento. Para migrar, basta trocar a rota: a requisição e a resposta são as mesmas, e a busca aceita até 50 resultados por página em vez de 20.

O guia está em SCJN, e você pode buscar sem escrever código nas ferramentas.