> ## 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 uma pergunta aberta a partir de fontes ao vivo e retorna um relatório citado em Markdown.

Faça uma pergunta aberta e receba um relatório escrito em Markdown com citações
numeradas, junto com a lista de fontes que o respaldam. É uma pesquisa
sobre fontes ao vivo, não uma consulta a um registro: uma chamada costuma levar
entre 10 e 30 segundos.

## Pesquisar uma pergunta

`POST /global/research/v1`

| Campo   | Tipo   | Notas                                                                        |
| ------- | ------ | ---------------------------------------------------------------------------- |
| `query` | string | **Obrigatório.** De 10 a 2.000 caracteres. A pergunta, em linguagem 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`          | Repete a pergunta consultada.                                                            |
| `report`         | O relatório em Markdown. Os números entre colchetes como `[1]` correspondem a `sources`. |
| `sources`        | As páginas em que o relatório se apoiou, cada uma com `title` e `url`.                   |
| `pages_analyzed` | Quantas páginas foram lidas.                                                             |

<Note>
  Um relatório é um ponto de partida, não uma citação. Confira o que você for usar
  com a fonte primária: para jurisprudência e registros públicos da Colômbia,
  os guias por país retornam o próprio registro.
</Note>

<Warning>
  Research tem a cota mais apertada da API: **10 solicitações por hora**
  por organização. Consulte [Limites de taxa](/pt/rate-limits).
</Warning>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>