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.
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.
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, e os planos em preços.