# Datasets: dados públicos prontos para consultar

**Publicado:** 26 de agosto de 2026 | **Autores:** Cristian Correa

---

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:

```bash
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:

```bash
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](https://docs.usecroma.com/pt/guides/peru/oece) e da [SCJN](https://docs.usecroma.com/pt/guides/mexico/scjn) têm todos os campos, e você pode buscar tesis sem escrever código nas [ferramentas](/mx/tools/buscar-teses-e-jurisprudencia).

---

**Mais novidades:** [Ver todas as entradas do changelog](/pt/changelog/sitemap.md) | [Croma](https://usecroma.com)