# Web Search sem teto por hora nos planos pagos

**Publicado:** 4 de outubro de 2026 | **Autores:** Cristian Correa

---

## O que muda

Até hoje, `POST /global/web-search/v1` aceitava 10 solicitações por hora por organização, em qualquer plano. Um agente que pesquisa um tema faz mais de 10 buscas numa sessão e recebia um `429` mesmo com créditos de sobra no plano. A partir de hoje:

| Plano | Teto por hora no Web Search |
| --- | --- |
| Free | 100 solicitações / hora (antes 10) |
| Hobby, Standard, Pro, Scale e Enterprise | Sem teto por hora |

Nos planos pagos cada busca consome 10 créditos do plano, como qualquer consulta ao vivo, e esses créditos são o único limite. O plano gratuito mantém um teto por hora, agora dez vezes maior.

```bash
curl https://api.croma.run/global/web-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "recuperação judicial empresas colombianas 2026", "limit": 10 }'
```

## Nos cabeçalhos

Num plano pago, o `RateLimit-Policy` do Web Search traz só a política de créditos, e `X-RateLimit-Remaining` informa os créditos que restam. No plano gratuito o teto por hora continua aparecendo, como `"webSearch";q=100;w=3600`. Se você passar dele, a resposta é `429` com `Retry-After`, como antes.

## O que não muda

O Research mantém 10 solicitações por hora, e Extract e Generate 60. Estão na tabela de [limites de taxa](https://docs.usecroma.com/pt/rate-limits).

## Um número a menos que confundia

O console mostrava "100 solicitações / 24h" como limite da organização. Esse número é de antes dos planos e não vale mais: a sua cota são os créditos do seu plano, que aparecem no seu saldo. Nós o removemos.

O guia do Web Search está na [documentação](https://docs.usecroma.com/pt/guides/global/web-search), e os planos em [preços](/pricing).

---

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