Ir al contenido principal
Español— Elegir un idioma
Menú

Activar la búsqueda en X en la API

Lección 8 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Acceso a datos de X en tiempo real
  2. Capacidades de la búsqueda en X
  3. Activación básica
  4. Activación mediante SDK
  5. Combinar la búsqueda en X y la búsqueda web
  6. Diferencias clave con la búsqueda web
  7. Puntos clave

Acceso a datos de X en tiempo real

La búsqueda en X (X Search) es una herramienta integrada única, específica de la API de Grok. Permite al modelo buscar publicaciones, perfiles e hilos en X (anteriormente Twitter) en tiempo real. Esto otorga a Grok una ventaja competitiva significativa frente a otras API de modelos de lenguaje, que normalmente carecen de acceso directo a redes sociales.

𝕏
Búsqueda nativa
10
Identificadores filtrables
🎥
Vídeo compatible
$5
/ 1.000 llamadas

Capacidades de la búsqueda en X

La búsqueda en X ofrece cuatro modos de búsqueda:

  • Búsqueda por palabras clave: encuentra publicaciones que contienen términos específicos.
  • Búsqueda semántica: localiza publicaciones relacionadas con un tema, incluso sin coincidencia exacta de palabras.
  • Búsqueda de usuarios: identifica perfiles relevantes.
  • Recuperación de hilos: accede a hilos de conversación completos.

El modelo selecciona automáticamente el modo más adecuado a la solicitud del usuario.

Activación básica

La activación funciona igual que la búsqueda web. Añades {"type": "x_search"} al array tools:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "¿Qué dicen los desarrolladores sobre la última actualización de React?",
  "tools": [
    {"type": "x_search"}
  ]
}

El modelo busca automáticamente en X publicaciones relevantes y las integra en su respuesta, incluyendo las citas correspondientes.

Activación mediante SDK

xAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="¿Cuáles son las reacciones en X sobre Grok 4?",
    tools=[client.tools.x_search()]
)

OpenAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="¿Cuáles son las reacciones en X sobre Grok 4?",
    tools=[{"type": "x_search"}]
)

Vercel AI SDK (JavaScript)

tools: [xai.tools.xSearch()]

Combinar la búsqueda en X y la búsqueda web

Puedes activar ambas herramientas simultáneamente para que el modelo contraste información de la web y de las redes sociales:

{
  "tools": [
    {"type": "web_search"},
    {"type": "x_search"}
  ]
}

El modelo decide cuál utilizar —o ambas— en función de la pregunta formulada. Una cuestión sobre opinión pública favorece la búsqueda en X, mientras que una pregunta factual prioriza la búsqueda web.

Diferencias clave con la búsqueda web

CaracterísticaBúsqueda webBúsqueda en X
FuenteToda la webSolo X/Twitter
FiltradoPor dominio (máx. 5)Por identificador (máx. 10)
FechasNo disponiblefrom_date / to_date
Imágenesenable_image_understandingenable_image_understanding
VídeoNo disponibleenable_video_understanding
Coste$5 / 1.000 llamadas$5 / 1.000 llamadas

La comprensión de vídeo es exclusiva de la búsqueda en X. Esta función permite al modelo analizar el contenido de los vídeos publicados en X.

Precios a 5 de agosto de 2026: los precios cambian con frecuencia; antes de calcular cualquier presupuesto, consulta la tabla de precios actualizada en la página oficial de modelos y precios de xAI.

Puntos clave

  • La búsqueda en X es una ventaja exclusiva de la API de Grok.
  • La activación utiliza {"type": "x_search"} en el array tools.
  • Cuatro modos de búsqueda: palabras clave, semántica, usuarios e hilos.
  • Combinable con la búsqueda web para contrastar información.
  • Compatible con la comprensión de imágenes y vídeo (exclusivo).