¿Qué devuelve Croma Web Search?
Devuelve resultados web estructurados con URL, título, autor, fecha publicada, highlights y score de relevancia.
Volver al catálogo
🌐Global
POST /v1/global/web-searchCroma Web Search
Búsqueda web con resúmenes destacados y metadata estructurada (URL, título, autor, fecha). Ideal para alimentar agentes de IA con contexto fresco.
Tomás Calle
Founder · Croma
Esta es una demo pública con ratelimit reducido. Para una API key de producción, agenda una llamada. Te respondo el mismo día.
Guía para integrar
- Fuente
- Proveedor de búsqueda web integrado por Croma.
- Actualización
- Consulta web bajo demanda; freshness depende de las páginas encontradas.
- Latencia
- Normalmente segundos; limitada a 10 búsquedas por hora.
- Autenticación
- Bearer API key en el header Authorization.
Casos de uso
- Alimentar agentes de IA con contexto web fresco.
- Recuperar URLs, títulos, fechas, autores y highlights.
- Crear flujos de research con resultados estructurados.
Parámetros de entrada
querystringreq- Consulta de búsqueda, 3–300 caracteres.
limitnumber- Cantidad de resultados, entre 1 y 25. Por defecto 10.
Campos de respuesta
resultsarray- Lista de resultados ordenados por relevancia.
results[].urlstring- URL canónica del resultado.
results[].titlestring- Título detectado del resultado.
results[].published_datestring- Fecha de publicación si está disponible.
results[].authorstring- Autor reportado si está disponible.
results[].highlightsarray- Fragmentos destacados relevantes a la consulta.
results[].scorenumber- Score de relevancia del resultado.
Preguntas frecuentes
¿Cuál es el límite de Web Search?
El endpoint está limitado a 10 búsquedas por hora porque usa una fuente upstream pagada y sensible al abuso.
Probar
Resultado
Edita el JSON y envíalo para ver resultados con resúmenes.
Referencia
curl https://api.usecroma.com/v1/global/web-search \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"croma api colombia","limit":10}'