Web Search OpenAI API: cómo buscar información actual en Internet
Web Search OpenAI API permite que modelos compatibles de OpenAI busquen información actual en Internet durante una respuesta. Mediante Responses API puedes habilitar la herramienta de búsqueda web para recuperar fuentes, consultar información reciente y generar respuestas fundamentadas en resultados disponibles en la web.
¿Qué es Web Search OpenAI API?
Web Search OpenAI API es una herramienta integrada que permite a determinados modelos de OpenAI realizar búsquedas en Internet mientras procesan una solicitud. El modelo puede decidir cuándo necesita información externa, realizar la búsqueda, analizar las fuentes obtenidas y utilizar esos resultados para construir su respuesta.
Qué permite hacer Web Search OpenAI API
La herramienta añade recuperación de información web a modelos que por sí solos dependen de su conocimiento y del contexto proporcionado.
Buscar información actual
Permite consultar información disponible actualmente en Internet.
Trabajar con fuentes
Los resultados pueden incluir información sobre las fuentes utilizadas.
Datos recientes
Resulta útil cuando la información puede haber cambiado después del knowledge cutoff.
Síntesis con IA
El modelo puede comparar los resultados recuperados y redactar una respuesta.
Integración
Puede formar parte de aplicaciones, asistentes y agentes.
Uso automático
El modelo puede decidir cuándo necesita buscar según la configuración de herramientas.
Cómo funciona Web Search en OpenAI API
Responses API coordina al modelo y la herramienta de búsqueda dentro de la misma respuesta.
El usuario pregunta
La aplicación envía una consulta que puede requerir información externa.
Se realiza la búsqueda
El modelo puede utilizar Web Search para recuperar información relevante.
Se genera la respuesta
El modelo sintetiza la información recuperada y produce el resultado.
Web Search OpenAI API dentro de Responses API
Web Search forma parte del sistema de herramientas integradas disponible para Responses API.
La búsqueda es administrada por OpenAI
A diferencia de Function Calling, no necesitas programar tu propio buscador. La herramienta de búsqueda es proporcionada por OpenAI para los modelos compatibles.
Si todavía no conoces la arquitectura general de Responses API, revisa primero nuestra guía.
Ver Responses API →Cómo habilitar Web Search OpenAI API
Una solicitud puede
declarar la herramienta
de búsqueda dentro
del array tools.
Ejemplo conceptual
{
"model": "gpt-5.6-sol",
"tools": [
{
"type": "web_search"
}
],
"input": "Busca información actual sobre inteligencia artificial."
}La sintaxis exacta y las opciones disponibles pueden variar según la versión de la API y el modelo utilizado.
El modelo puede decidir cuándo buscar
Cuando la herramienta está disponible, el modelo puede determinar si la consulta necesita información desde Internet.
Analiza la pregunta enviada por el usuario.
Evalúa si necesita información externa.
Ejecuta una búsqueda cuando corresponde.
Procesa los resultados recuperados.
Genera una respuesta usando esa información.
web_search_call en la respuesta
Cuando el modelo utiliza la herramienta, Responses API puede producir un item relacionado con la búsqueda realizada.
La búsqueda forma parte del output
{
"type": "web_search_call",
"status": "completed"
}Una respuesta puede contener diferentes tipos de items, incluyendo tool calls, mensajes y reasoning.
Cómo obtener las fuentes de Web Search
Responses API permite solicitar información adicional sobre las fuentes utilizadas durante una búsqueda web.
web_search_call.action.sources
{
"include": [
"web_search_call.action.sources"
]
}Conocer las fuentes puede ayudarte a mostrar referencias, auditar resultados o analizar de dónde proviene la información.
Cuándo utilizar Web Search OpenAI API
La búsqueda web es especialmente útil cuando una respuesta depende de información cambiante.
Noticias: acontecimientos recientes que el modelo no podría conocer solo desde su entrenamiento.
Productos: documentación, lanzamientos y cambios recientes.
Empresas: información pública que puede cambiar con el tiempo.
Investigación: localizar y sintetizar fuentes disponibles en Internet.
Asistentes: responder preguntas sobre información actual.
Agentes: utilizar la web como una fuente externa dentro de un workflow.
Cuándo no necesitas una búsqueda web
No todas las preguntas justifican utilizar una herramienta externa.
Transformación de texto
Reescribir, resumir o traducir contenido proporcionado por el usuario.
Lógica interna
Tareas que pueden resolverse completamente con el contexto ya disponible.
Cada herramienta adicional puede incrementar latencia, complejidad y costo.
Modelos OpenAI con Web Search
Los modelos actuales pueden ofrecer diferentes herramientas cuando se utilizan mediante Responses API.
| Modelo | Web Search | Orientación |
|---|---|---|
| GPT-6 Astra | Compatible | Máxima capacidad |
| GPT-5.6 Sol | Compatible | Trabajo profesional complejo |
| GPT-5.6 Terra | Compatible | Equilibrio capacidad/costo |
| GPT-5.6 Luna | Compatible | Alto volumen y bajo costo |
La búsqueda web no obliga a utilizar siempre el modelo más potente.
Comparar modelos →Web Search con GPT-5.6 Sol
GPT-5.6 Sol incluye soporte para Web Search cuando se utiliza mediante Responses API.
Búsqueda + razonamiento complejo
Puede ser apropiado cuando además de recuperar información reciente necesitas analizar múltiples datos, comparar fuentes o realizar razonamiento complejo.
Ver GPT-5.6 Sol →Web Search con Terra y Luna
Para grandes volúmenes, también puedes evaluar modelos de menor costo.
Equilibrio
Adecuado cuando buscas una combinación de capacidad y costo.
Ver Terra →Escala
Puede resultar interesante para workloads sensibles al costo y de gran volumen.
Ver Luna →Web Search vs conocimiento del modelo
Son dos fuentes de información diferentes y pueden complementarse.
| Aspecto | Conocimiento del modelo | Web Search |
|---|---|---|
| Origen | Entrenamiento y contexto | Información recuperada desde la web |
| Actualidad | Limitada por cutoff y contexto | Puede recuperar información reciente |
| Fuentes externas | No necesariamente | Sí |
| Latencia | Generalmente menor | Puede aumentar |
| Costo adicional | Tokens del modelo | Puede incorporar cargos de herramienta |
Web Search vs Function Calling
Ambas son herramientas, pero resuelven necesidades diferentes.
| Aspecto | Web Search | Function Calling |
|---|---|---|
| Objetivo | Buscar información pública | Solicitar una función propia |
| Infraestructura | OpenAI | Tu backend |
| Fuente | Internet | Tu sistema o API |
| Ejemplo | Buscar una noticia | Consultar inventario |
| Efectos externos | Principalmente recuperación | Puede ejecutar acciones |
Un agente puede buscar información pública y posteriormente utilizar una función propia para realizar una acción.
Ver Function Calling →Web Search vs File Search
La diferencia principal está en el origen de la información.
| Característica | Web Search | File Search |
|---|---|---|
| Fuente | Web pública | Archivos incorporados al sistema |
| Información actual | Sí, según disponibilidad web | Depende de tus archivos |
| Datos privados propios | No es su objetivo | Sí |
| Uso típico | Investigación externa | Knowledge base privada |
Una aplicación avanzada puede combinar información pública mediante Web Search con documentos internos mediante File Search.
Controlar el uso de la búsqueda web
Responses API permite controlar cómo el modelo selecciona las herramientas.
| Modo | Comportamiento general |
|---|---|
auto |
El modelo decide si responde o utiliza una herramienta |
required |
Debe utilizar una o más herramientas |
none |
No utiliza herramientas |
Permite que el modelo evite búsquedas cuando la pregunta no necesita información externa.
Controlar el contexto de búsqueda
Dependiendo de la herramienta y versión utilizada, la configuración puede ofrecer controles adicionales sobre cómo se realiza una búsqueda web.
Limita la búsqueda a lo necesario para la tarea.
Proporciona instrucciones claras sobre qué información necesitas.
Solicita comparación de varias fuentes cuando sea importante.
Define el formato esperado de la respuesta.
Conserva las fuentes cuando necesites trazabilidad.
Fuentes y respuestas fundamentadas
Cuando una aplicación utiliza información web, conviene conservar la relación entre las afirmaciones y sus fuentes.
No ocultes de dónde proviene la información
En aplicaciones de investigación, noticias o conocimiento, mostrar referencias puede mejorar la capacidad del usuario para verificar la respuesta.
Web Search para investigación
La combinación de razonamiento y búsqueda permite construir workflows de investigación más completos.
Buscar información relacionada con la consulta.
Seguir fuentes relevantes.
Comparar afirmaciones entre distintas páginas.
Identificar información contradictoria.
Sintetizar los hallazgos en una respuesta final.
Web Search OpenAI API para chatbots
Un chatbot tradicional puede quedar desactualizado cuando depende exclusivamente del conocimiento interno del modelo.
Consultar cuando la pregunta lo necesita
Puedes permitir que el modelo responda directamente cuando conoce la información y utilice Web Search cuando necesita datos externos recientes.
Web Search dentro de un agente de IA
La búsqueda web puede convertirse en una herramienta más dentro del conjunto de capacidades de un agente.
Web Search para información externa.
File Search para conocimiento interno.
Function Calling para ejecutar lógica propia.
MCP para conectarse a otros sistemas.
Esto permite construir workflows donde la IA selecciona diferentes fuentes y capacidades según la tarea.
Precio de Web Search OpenAI API
El costo total puede incluir tanto el uso del modelo como cargos asociados a la herramienta de búsqueda.
No calcules solamente los tokens
Las herramientas especializadas pueden utilizar cargos por llamada u otras métricas, además de los tokens procesados por el modelo.
Los precios pueden cambiar. Revisa nuestra guía y posteriormente confirma los valores en OpenAI.
Ver precios OpenAI API →Cómo reducir búsquedas innecesarias
Utilizar la herramienta solamente cuando aporta valor ayuda a controlar latencia y costos.
Permite auto
cuando no sea obligatorio buscar.
Evita activar investigación extensa para preguntas simples.
Formula consultas específicas.
Utiliza modelos de menor costo cuando el workload lo permita.
Monitoriza el número de web search calls por proyecto.
Monitorizar llamadas de Web Search
OpenAI dispone de información de uso específica para llamadas de búsqueda web.
Analiza qué está consumiendo tu aplicación
Para sistemas en producción, monitorizar las llamadas de Web Search permite entender volumen, costos y comportamiento por modelo o proyecto.
Web Search y los límites de OpenAI API
Una respuesta con herramientas continúa estando condicionada por la capacidad disponible en la plataforma.
Planifica el tráfico de producción
Los modelos tienen límites diferentes según el usage tier, por lo que conviene dimensionar tanto el modelo como las herramientas.
Ver límites OpenAI API →La información web sigue siendo contenido externo
Recuperar una página no convierte automáticamente su contenido en información confiable o segura.
No asumas que todas las fuentes son correctas.
Contrasta afirmaciones importantes.
Prioriza fuentes apropiadas para cada tema.
No conviertas contenido web directamente en acciones sensibles.
Conserva supervisión sobre workflows con efectos externos.
Documentación oficial de Web Search OpenAI API
OpenAI continúa desarrollando sus herramientas, por lo que debes consultar la referencia oficial antes de desplegar una integración en producción.
Responses API y Web Search
Revisa herramientas, parámetros, modelos compatibles y campos disponibles en las respuestas.
Consultar documentación oficial →Guías relacionadas con Web Search OpenAI API
Continúa explorando Responses API y sus herramientas.
FAQ sobre Web Search OpenAI API
Respuestas sobre búsquedas, modelos, fuentes, Responses API y costos.
Es una herramienta que permite a modelos compatibles buscar información en Internet durante una respuesta de OpenAI API.
Sí. Web Search es una de las herramientas integradas disponibles mediante Responses API.
Sí. OpenAI publica Web Search entre las herramientas compatibles con GPT-5.6 Sol mediante Responses API.
Sí. GPT-5.6 Terra aparece actualmente con soporte para Web Search.
Sí. Web Search figura entre las herramientas compatibles con GPT-5.6 Luna.
Responses API dispone de opciones para incluir información adicional sobre las fuentes utilizadas por Web Search.
No. Web Search recupera información desde Internet, mientras File Search trabaja con archivos incorporados al sistema.
No. Web Search es una herramienta integrada para recuperar información web. Function Calling permite solicitar funciones proporcionadas por tu aplicación.
Las herramientas de búsqueda pueden utilizar cargos específicos además del consumo de tokens del modelo.
Cuando una respuesta depende de información externa, reciente o que puede haber cambiado después del knowledge cutoff del modelo.
Continúa con File Search de OpenAI
Web Search permite obtener información desde Internet. El siguiente paso es aprender a conectar los modelos con tus propios documentos y bases de conocimiento.
Ver File Search →