Web Search API: qué es la beta de Cloudflare

⏱️ Lectura: 10 min

Cloudflare dejó de forzar a los agentes de IA a adivinar URLs o confiar en datos de entrenamiento viejos: desde el 2 de octubre de 2026 pueden buscar en internet en tiempo real con Web Search API, el nuevo servicio en beta que corre sobre AI Gateway.

📑 En este artículo

1. TL;DR
2. Qué es Web Search API
3. Qué pasó
4. Contexto e historia
5. Detalles técnicos
6. Impacto y análisis
7. Qué sigue
8. Preguntas frecuentes
   1. ¿Qué proveedores soporta Web Search API al lanzamiento?
   2. ¿Cuánto cuesta usar la API de búsqueda web de Cloudflare?
   3. ¿Hace falta un Worker para usar el servicio de búsqueda para agentes de IA?
   4. ¿Qué pasa con los datos que procesa la herramienta de búsqueda en vivo de Cloudflare?
   5. ¿AI Gateway Web Search reemplaza una búsqueda normal en Google?
9. Referencias
   1. 📚 Artículos relacionados

La API conecta con tres proveedores de búsqueda externos y cobra el precio de lista de cada uno, sin margen adicional de Cloudflare. Para cualquier app o Worker que ya use AI Gateway, sumar búsqueda en vivo implica una llamada más, no una integración nueva desde cero.

TL;DR

• Cloudflare lanzó Web Search API en beta el 2 de octubre de 2026 para búsquedas en tiempo real.
• Tres proveedores disponibles al lanzamiento: Ceramic.ai, Exa y Linkup, todos con Zero Data Retention.
• Corre sobre AI Gateway: queda en los logs y se factura al precio de lista del proveedor, sin margen extra.
• Los desarrolladores pueden usar su propia clave de API del proveedor en vez de la de Cloudflare.
• La API se invoca vía REST o desde un Worker con el binding env.AI.websearch().

Qué es Web Search API

Web Search API es el servicio en beta de Cloudflare que permite a agentes y aplicaciones de IA ejecutar búsquedas reales en internet, en vez de depender solo del conocimiento entrenado del modelo. Corre dentro de AI Gateway y conecta con proveedores externos de búsqueda bajo una sola interfaz.

No reemplaza al modelo de lenguaje: lo complementa. El agente sigue razonando y redactando con su LLM de siempre, pero ahora puede pedir resultados de búsqueda frescos a mitad de esa conversación y usarlos como contexto antes de responder.

Qué pasó

El anuncio llegó el 2 de octubre de 2026 en el changelog oficial de Cloudflare. Web Search API quedó disponible en beta pública, sin lista de espera, para cualquier cuenta que ya tenga configurado un gateway de IA.

Al lanzamiento hay tres proveedores para elegir: Ceramic.ai, Exa y Linkup. Los tres soportan Zero Data Retention para las solicitudes hechas a través de Cloudflare y se comprometieron con los estándares de rastreo verificado de bots de la compañía. Ese compromiso importa porque son los mismos buscadores los que indexan la web para entrenar y alimentar modelos de lenguaje, y que declaren cómo rastrean reduce la fricción con los sitios que bloquean bots genéricos.

Contexto e historia

AI Gateway existe desde 2024 como la capa que Cloudflare puso entre las apps y los proveedores de modelos de lenguaje. Centraliza logs, caché, límites de gasto y reintentos para cualquier llamada a un LLM, sin que el desarrollador tenga que instrumentar nada por su cuenta. Web Search API extiende esa misma capa a un problema distinto: no es inferencia, sino recuperación de información actual.

El problema que ataca no es nuevo. Los modelos de lenguaje tienen una fecha de corte de entrenamiento y, sin acceso a la web, inventan URLs o citan datos vencidos cuando se les pregunta algo reciente. Dar a un agente la capacidad de buscar y leer resultados antes de responder ya lo hacen ChatGPT, Gemini y Perplexity con sus propios buscadores internos.

Esta técnica se conoce como retrieval-augmented generation o RAG. En vez de confiar solo en los pesos del modelo, el sistema recupera documentos externos relevantes y los inyecta en el contexto antes de generar la respuesta final. La API de búsqueda web de Cloudflare aplica esa misma idea, pero usando la web abierta como fuente en lugar de una base de documentos privada.

La diferencia de Cloudflare es que no construyó un motor de búsqueda propio. Empaquetó el acceso a tres motores externos bajo una sola factura y un solo panel de logs, en lugar de competir con ellos.

Detalles técnicos

La API de búsqueda web de Cloudflare es un endpoint más dentro de AI Gateway. La petición entra, Cloudflare la enruta al proveedor elegido, ese proveedor busca en su índice propio y la respuesta vuelve en JSON con los resultados. El costo se cobra al crédito de AI Gateway de la cuenta, al precio de lista de ese proveedor, sin margen adicional de Cloudflare. También se puede usar la propia clave de API del proveedor en vez de pagar a través de Cloudflare.

La llamada directa usa REST:

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ \
  --request POST \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "What are some fun things to do in Salt Lake City as fall approaches?",
    "provider": "ceramic",
    "limit": 5,
    "options": { "gateway": { "id": "default" } }
  }'

Esa misma llamada, desde un Worker con el binding de IA, se reduce a un método:

const response = await env.AI.websearch({
  gatewayId: "default",
  query: "What are some fun things to do in Salt Lake City as fall approaches?",
  provider: "exa",
  limit: 5,
});

const resultados = await response.json();

El parámetro provider es lo único que cambia entre Ceramic, Exa y Linkup. La forma de la petición es idéntica, así que comparar calidad de resultados entre proveedores no exige reescribir código, solo ese string.

Esa visibilidad de precio es nueva. Hasta ahora, para saber cuánto cobraba un proveedor de búsqueda externo había que revisar la documentación de cada uno por separado. Con la herramienta de búsqueda en vivo de Cloudflare, el costo de cada llamada queda en el mismo log que ya usa un equipo para auditar el gasto en modelos de lenguaje.

flowchart TD
    A["Agente o app de IA"] --> B["AI Gateway de Cloudflare"]
    B --> C["Proveedor: Ceramic, Exa o Linkup"]
    C --> D[("Indice del proveedor")]
    D --> C
    C --> B
    B --> A

Para confirmar que una búsqueda pasó por la herramienta de búsqueda en vivo de Cloudflare hay que revisar el log del gateway en el dashboard de Cloudflare, dentro de AI Gateway, sección Logs. Cada llamada aparece ahí con el proveedor usado, la latencia y el costo cobrado. No hay un comando de CLI separado para esto: el log del gateway es la única fuente documentada para verificarlo.

Impacto y análisis

El cambio importa porque mueve la búsqueda al mismo lugar donde ya viven los costos de inferencia. Antes, conectar un agente a un buscador externo significaba una integración, una factura y un panel de logs distintos por cada proveedor. Ahora, alguien que ya mide gasto de tokens en AI Gateway ve en el mismo panel cuánto gasta buscando.

La promesa de no agregar margen sobre el precio del proveedor es inusual en un mercado donde varias plataformas de agentes cobran un extra por cada servicio empaquetado. Microsoft vende su propio Bing Search API y Google tiene su Programmable Search Engine. Perplexity, por su parte, cobra por acceso a su buscador interno, y cada uno define su propia estructura de precios.

El problema de fondo sigue siendo la fecha de corte del modelo. Un LLM entrenado hasta cierto mes no sabe qué pasó después, y preguntarle por algo reciente lo empuja a inventar. Conectarlo a una búsqueda real no arregla el razonamiento del modelo, pero sí le da datos frescos para razonar sobre algo verificable en vez de sobre un recuerdo aproximado de su entrenamiento.

💭 Clave: Cloudflare no construyó un buscador propio para esto. Apostó a ser el punto único de facturación y logs sobre motores de terceros, igual que ya hace con los modelos de lenguaje dentro de AI Gateway.

Qué sigue

Cloudflare no publicó una fecha para sacar Web Search API de beta ni confirmó si sumará más proveedores de búsqueda. La documentación de AI Gateway sí deja la puerta abierta a extender el catálogo de servicios conectados más allá de modelos de lenguaje.

Para quien ya corre agentes sobre Cloudflare, el paso lógico es medir en producción cuál de los tres proveedores devuelve mejores resultados para su caso de uso. Cambiar de uno a otro no cuesta más que editar un parámetro.

La limitación más clara hoy es que sigue siendo beta. Cloudflare no promete SLA ni continuidad garantizada de los tres proveedores actuales, así que conviene no construir un flujo crítico que dependa de uno solo sin un plan de respaldo.

📖 Resumen en Telegram: Ver resumen

Probalo vos: si ya tenés un gateway de IA en Cloudflare, mandá una búsqueda de prueba al endpoint /ai/websearch/ con tu proveedor favorito y revisá el resultado en el log del gateway.

Preguntas frecuentes

¿Qué proveedores soporta Web Search API al lanzamiento?

Tres: Ceramic.ai, Exa y Linkup. Los tres corren con Zero Data Retention cuando la solicitud pasa por Cloudflare y se puede elegir cuál usar con el parámetro provider de cada llamada.

¿Cuánto cuesta usar la API de búsqueda web de Cloudflare?

Se cobra al crédito de AI Gateway de la cuenta, al precio de lista que cada proveedor publica, sin margen adicional de Cloudflare. También se puede usar una clave de API propia del proveedor en lugar de pagar a través de Cloudflare.

¿Hace falta un Worker para usar el servicio de búsqueda para agentes de IA?

No. Se puede llamar directo por REST a /accounts/{account_id}/ai/websearch/, o desde un Worker con el método env.AI.websearch() del binding de IA.

¿Qué pasa con los datos que procesa la herramienta de búsqueda en vivo de Cloudflare?

Ceramic.ai, Exa y Linkup se comprometieron a Zero Data Retention para las solicitudes que llegan vía Cloudflare, lo que significa que no retienen la consulta ni los resultados más allá de responder la petición.

¿AI Gateway Web Search reemplaza una búsqueda normal en Google?

No está pensado para eso. Es una API para que un agente o una app la llame programáticamente, no para un usuario humano que escribe en una caja de búsqueda.

Referencias

• Cloudflare Changelog: el anuncio oficial de Web Search API, con los ejemplos de REST y del binding de Workers.
• Cloudflare AI Gateway Docs: documentación de la capa de logs, caché y facturación sobre la que corre el nuevo servicio.
• Exa: uno de los tres proveedores de búsqueda disponibles al lanzamiento.
• Linkup: el tercer proveedor de búsqueda integrado en la beta.

📱 ¿Te gusta este contenido? Únete a nuestro canal de Telegram @programacion donde publicamos a diario lo más relevante de tecnología, IA y desarrollo. Resúmenes rápidos, contenido fresco todos los días.

Imagen destacada: Foto de GuerrillaBuzz en Unsplash