Qué cambia#
Hasta hoy, POST /global/web-search/v1 aceptaba 10 solicitudes por hora por organización, en cualquier plan. Un agente que investiga un tema hace más de 10 búsquedas en una sesión, y se encontraba con un 429 aunque al plan le quedaran créditos de sobra. Desde hoy:
| Plan | Tope por hora en Web Search |
|---|---|
| Free | 100 solicitudes / hora (antes 10) |
| Hobby, Standard, Pro, Scale y Enterprise | Sin tope por hora |
En los planes de pago cada búsqueda consume 10 créditos del plan, como cualquier consulta en vivo, y esos créditos son el único límite. En el plan gratuito el tope por hora sigue, ahora diez veces más amplio.
curl https://api.croma.run/global/web-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "superintendencia de sociedades insolvencia 2026", "limit": 10 }'En los encabezados#
En un plan de pago, RateLimit-Policy de Web Search trae solo la política de créditos y X-RateLimit-Remaining reporta los créditos que quedan. En el plan gratuito sigue apareciendo el tope por hora, "webSearch";q=100;w=3600. Si lo superas, la respuesta es 429 con Retry-After, igual que antes.
Lo que no cambia#
Research mantiene 10 solicitudes por hora, y Extract y Generate 60. Están en la tabla de límites de tasa.
Un dato menos que confundía#
La consola mostraba "100 solicitudes / 24h" como límite de la organización. Ese número es de antes de los planes y ya no aplica: tu cupo son los créditos de tu plan, que ves en tu saldo. Lo quitamos.
La guía de Web Search está en la documentación, y los planes en precios.