> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Research

> Responde una pregunta abierta a partir de fuentes en vivo y devuelve un informe citado en Markdown.

Haz una pregunta abierta y recibe un informe escrito en Markdown con citas
numeradas, junto con la lista de fuentes que lo respaldan. Es una investigación
sobre fuentes en vivo, no una consulta a un registro: una llamada suele tardar
entre 10 y 30 segundos.

## Investigar una pregunta

`POST /global/research/v1`

| Campo   | Tipo   | Notas                                                                        |
| ------- | ------ | ---------------------------------------------------------------------------- |
| `query` | string | **Obligatorio.** De 10 a 2.000 caracteres. La pregunta, en lenguaje natural. |

```bash theme={"dark"}
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?" }'
```

| Campo            | Notas                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------- |
| `query`          | Repite la pregunta consultada.                                                           |
| `report`         | El informe en Markdown. Los números entre corchetes como `[1]` corresponden a `sources`. |
| `sources`        | Las páginas en las que se apoyó el informe, cada una con `title` y `url`.                |
| `pages_analyzed` | Cuántas páginas se leyeron.                                                              |

<Note>
  Un informe es un punto de partida, no una cita. Contrasta lo que vayas a usar
  con la fuente primaria: para jurisprudencia y registros públicos de Colombia,
  las guías por país devuelven el registro mismo.
</Note>

<Warning>
  Research tiene la cuota más ajustada de la API: **10 solicitudes por hora**
  por organización. Consulta [Límites de tasa](/es/rate-limits).
</Warning>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>