Hoje apresentamos os Datasets, um novo conceito na plataforma Croma. Até agora, cada endpoint respondia a uma pergunta por vez, no ritmo da fonte. Um dataset é a fonte inteira pronta para consultar: completa, organizada, atualizada e sempre disponível, com respostas em milissegundos. Os dois primeiros já estão em produção: as contratações públicas do Peru (OECE) e as tesis da Suprema Corte do México (SCJN).
O que é um dataset#
Um dataset é a fonte inteira, não uma consulta pontual. São os mesmos registros tipados que você já conhece, mas todos de uma vez e organizados para responder perguntas. O da OECE reúne todos os procedimentos de contratação pública do Peru; o da SCJN, as 311.878 tesis publicadas pela Corte, com o texto completo. Com o conjunto inteiro disponível, uma busca em todas as adjudicações a um fornecedor ou em toda a jurisprudência é uma única chamada, e volta em milissegundos.
O que você pode perguntar agora#
Os filtros deixam de se limitar aos que o buscador da fonte oferece. Como o dataset é organizado para ser consultado, indexamos o que faz sentido perguntar. A navegação de tesis aceita órgão, forma de integração e janela de publicação, três recortes que o Semanario não permite combinar:
curl https://api.croma.run/mx/scjn/tesis-browse/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"court": "Primera Sala",
"formation": "Reiteración",
"published_from": "2026-01-01"
}'Na OECE, supplier_ruc devolve todos os procedimentos com uma adjudicação a esse fornecedor, não importa quando ela aconteceu. Estes são os endpoints que hoje respondem a partir de um dataset:
| Endpoint | Dataset |
|---|---|
POST /pe/oece/processes-search/v1 | Todos os procedimentos de contratação pública do Peru |
POST /pe/oece/process/v1 | Um procedimento completo pelo seu OCID |
POST /mx/scjn/tesis-browse/v1 | Todas as tesis da SCJN, na íntegra |
Sempre atualizado, sempre disponível#
Um dataset responde a qualquer hora com a mesma velocidade, e cada resposta diz até quando os dados estão atualizados: as_of, para que você nunca precise adivinhar. As tesis acompanham a publicação semanal do Semanario; os procedimentos são atualizados todo mês. E como cada registro guarda quando mudou, updated_after devolve só o que é novo desde a sua última consulta:
curl https://api.croma.run/pe/oece/processes-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"department": "CUSCO",
"category": "works",
"updated_after": "2026-08-01"
}'O que vem a seguir#
Vamos incluir mais datasets para que os dados públicos sejam acessíveis, consultáveis e prontos para agentes. A logística fica com a gente: garantir que cada dataset esteja completo, atualizado e disponível quando você consultar. Você se concentra no seu produto. Os guias da OECE e da SCJN têm todos os campos, e você pode buscar tesis sem escrever código nas ferramentas.