# Research em segundos e endpoints de páginas mais simples

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

---

Renovamos por dentro os quatro endpoints de conteúdo web sob `/global`. As rotas, a autenticação e os limites continuam iguais; mudam quatro detalhes do contrato que vale a pena revisar se você já os usa.

## Research em poucos segundos

`POST /global/research/v1` agora responde em poucos segundos, e não nos 10 a 30 que anunciamos no lançamento. O formato da resposta não muda: `report` em markdown com citações numeradas e `sources` com as páginas que o embasam. `pages_analyzed` passa a indicar quantas fontes embasam o relatório.

```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?" }'
```

## Sai o `country`

Os endpoints de páginas não aceitam mais `country`. Se você continuar enviando, ele é ignorado; não há erro para corrigir. A leitura de uma página não depende do país de onde ela é consultada.

## `effort` diz o que faz

| Valor | O que você recebe |
| --- | --- |
| `min` | A resposta mais rápida; pode vir de uma cópia recente da página. |
| `standard` | O equilíbrio padrão. |
| `max` | Sempre lê a página ao vivo, inclusive as que são montadas no navegador. |

## Metadados mais honestos

Com `include_metadata: true`, `metadata` traz `title`, `author`, `published_at` e `image`. Um campo que a página não declara chega como `null`. Os campos que quase nunca conseguíamos preencher (descrição, nome do site, palavras-chave, número de páginas) saem do contrato.

## 404 quando não há nada para ler

`POST /global/extract/json/v1` e `POST /global/generate/json/v1` agora respondem `404` quando a página não tem conteúdo legível, assim como `extract/markdown`, em vez de devolver um objeto vazio. A mensagem indica qual opção mudar.

Os guias estão atualizados: [extract](https://docs.usecroma.com/pt/guides/global/extract), [generate](https://docs.usecroma.com/pt/guides/global/generate) e [research](https://docs.usecroma.com/pt/guides/global/research).

---

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