Hoy presentamos Datasets, un nuevo concepto en la plataforma Croma. Hasta ahora cada endpoint respondía una pregunta a la vez, al ritmo de la fuente. Un dataset es la fuente entera lista para consultar: completa, organizada, al día y siempre disponible, con respuestas en milisegundos. Los dos primeros ya están en producción: la contratación pública del Perú (OECE) y las tesis de la Suprema Corte de México (SCJN).
Qué es un dataset#
Un dataset es la fuente entera, no una consulta puntual. Son los mismos registros tipados que ya conoces, pero todos a la vez y organizados para preguntar. El de OECE reúne todos los procedimientos de contratación pública del Perú; el de la SCJN, las 311.878 tesis publicadas por la Corte, con su texto completo. Con el conjunto entero disponible, una búsqueda sobre todas las adjudicaciones a un proveedor o sobre toda la jurisprudencia es una sola llamada, y vuelve en milisegundos.
Lo que ahora puedes preguntar#
Los filtros dejan de estar limitados a los que ofrece el buscador de la fuente. Como el dataset está organizado para consultarse, indexamos lo que tiene sentido preguntar. El recorrido de tesis acepta órgano, forma de integración y ventana de publicación, tres cortes que el Semanario no 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"
}'En OECE, supplier_ruc devuelve todos los procedimientos con una adjudicación a ese proveedor, sin importar cuándo se adjudicó. Estos son los endpoints que hoy responden desde un dataset:
| Endpoint | Dataset |
|---|---|
POST /pe/oece/processes-search/v1 | Todos los procedimientos de contratación pública del Perú |
POST /pe/oece/process/v1 | Un procedimiento completo por su OCID |
POST /mx/scjn/tesis-browse/v1 | Todas las tesis de la SCJN, íntegras |
Siempre al día, siempre disponible#
Un dataset responde a cualquier hora con la misma velocidad, y cada respuesta dice hasta cuándo están al día los datos: as_of, para que nunca tengas que adivinarlo. Las tesis siguen la publicación semanal del Semanario; los procedimientos se actualizan cada mes. Y como cada registro conserva cuándo cambió, updated_after te devuelve solo lo nuevo desde tu ú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"
}'Qué sigue#
Vamos a incluir más datasets para que los datos públicos sean accesibles, consultables y listos para agentes. De la logística nos encargamos nosotros: que cada dataset esté completo, al día y disponible cuando lo consultes. Tú te concentras en tu producto. Las guías de OECE y SCJN tienen todos los campos, y puedes buscar tesis sin escribir código en las herramientas.