# Research en segundos y endpoints de páginas más simples

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

---

Renovamos por dentro los cuatro endpoints de contenido web bajo `/global`. Las rutas, la autenticación y los límites siguen iguales; cambian cuatro detalles del contrato que conviene revisar si ya los usas.

## Research en unos segundos

`POST /global/research/v1` ahora responde en unos pocos segundos, no en los 10 a 30 que anunciamos al lanzarlo. La forma de la respuesta no cambia: `report` en markdown con citas numeradas y `sources` con las páginas que lo respaldan. `pages_analyzed` pasa a indicar cuántas fuentes respaldan el informe.

```bash
curl https://api.croma.run/global/research/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "¿Qué cambios trajo la Ley 2195 de 2022 en materia de responsabilidad de personas jurídicas en Colombia?" }'
```



Los endpoints de páginas ya no aceptan `country`. Si lo sigues enviando, se ignora; no hay error que corregir. La lectura de una página no depende del país desde donde se consulta.

## `effort` dice lo que hace

| Valor | Qué obtienes |
| --- | --- |
| `min` | La respuesta más rápida; puede venir de una copia reciente de la página. |
| `standard` | El balance por defecto. |
| `max` | Siempre lee la página en vivo, incluidas las que se construyen en el navegador. |

## Metadatos más honestos

Con `include_metadata: true`, `metadata` trae `title`, `author`, `published_at` e `image`. Un campo que la página no declara llega como `null`. Los campos que casi nunca podíamos llenar (descripción, nombre del sitio, palabras clave, número de páginas) salen del contrato.

## 404 cuando no hay nada que leer

`POST /global/extract/json/v1` y `POST /global/generate/json/v1` ahora responden `404` cuando la página no tiene contenido legible, igual que `extract/markdown`, en lugar de devolver un objeto vacío. El mensaje indica qué opción cambiar.

Las guías están actualizadas: [extract](https://docs.usecroma.com/guides/global/extract), [generate](https://docs.usecroma.com/guides/global/generate) y [research](https://docs.usecroma.com/guides/global/research).

---

**Más novedades:** [Ver todas las entradas del changelog](/es/changelog/sitemap.md) | [Croma](https://usecroma.com)