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

Activar la búsqueda X para investigación en Twitter

Lección 5 de 14 Actualizado el 30 de julio de 2026 Principiante
En esta página
  1. Accede al feed en tiempo real de X desde tu API
  2. Activar la búsqueda X
  3. Las cuatro capacidades de la búsqueda X
  4. Uso con diferentes SDK
  5. Combinar web_search y x_search
  6. Práctica guiada
  7. Puntos clave

Accede al feed en tiempo real de X desde tu API

X (anteriormente Twitter) sigue siendo la plataforma de referencia para obtener información en tiempo real: anuncios de empresas, reacciones a noticias, tendencias emergentes y debates públicos. La herramienta x_search de la API de Grok te permite consultar este feed directamente desde tus aplicaciones, sin necesidad de una suscripción separada a la API de X ni de gestionar suscripciones adicionales.

Búsqueda X con Grok

Mientras que el antiguo endpoint de Chat Completions ofrecía un parámetro sources: ["x"] dentro de search_parameters, la API de Responses proporciona una herramienta dedicada con capacidades de filtrado mucho más precisas.

10
cuentas filtrables
4
tipos de búsqueda
$5
por cada 1.000 llamadas
Vídeo
análisis exclusivo

Activar la búsqueda X

La activación sigue el mismo principio que web_search. Añades la herramienta x_search al array tools:

response = client.responses.create(
    model="grok-4.5",
    input="¿Qué dice la gente sobre la Ley de IA en X hoy?",
    tools=[{"type": "x_search"}]
)

print(response.output_text)

El modelo decide automáticamente cuándo consultar X basándose en la naturaleza de tu prompt. Las preguntas sobre actualidad, opinión pública o tendencias activarán la búsqueda de forma natural.

Las cuatro capacidades de la búsqueda X

La herramienta x_search va más allá de la simple búsqueda por palabras clave. Ofrece cuatro modos de consulta:

  • Búsqueda por palabras clave: encuentra publicaciones que contengan términos específicos.
  • Búsqueda semántica: localiza publicaciones relacionadas con un concepto, incluso sin usar las palabras exactas.
  • Búsqueda de usuarios: identifica cuentas relevantes sobre un tema.
  • Recuperación de hilos: reconstruye hilos de conversación completos.

El modelo elige automáticamente el modo más adecuado según tu solicitud. No necesitas especificar explícitamente qué modo utilizar.

Uso con diferentes SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

response = client.chat.create(
    model="grok-4.5",
    tools=[x_search()]
)

SDK compatible con OpenAI

response = client.responses.create(
    model="grok-4.5",
    input="Tendencias tecnológicas en X esta semana",
    tools=[{"type": "x_search"}]
)

Vercel AI SDK (JavaScript)

import { xai } from '@ai-sdk/xai';

const response = await generateText({
  model: xai.responses('grok-4.5'),
  prompt: 'Tendencias tecnológicas en X esta semana',
  tools: [xai.tools.xSearch()]
});

Puedes activar ambas herramientas simultáneamente para obtener una visión completa de un tema. El modelo elegirá la herramienta más relevante o utilizará ambas si es necesario:

response = client.responses.create(
    model="grok-4.5",
    input="Análisis completo del último keynote de Apple",
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ]
)

En este caso, el modelo podría buscar artículos de prensa mediante web_search y reacciones en tiempo real mediante x_search, para luego sintetizar ambas perspectivas en su respuesta.

Práctica guiada

Crea un script que utilice x_search para monitorizar debates en torno a un tema profesional que te interese. Prueba con consultas sobre actualidad y observa cómo el modelo sintetiza opiniones y hechos procedentes de X.

Puntos clave

  • La herramienta x_search se activa con {"type": "x_search"} en el array tools.
  • Admite cuatro tipos de búsqueda: palabras clave, semántica, usuarios e hilos.
  • El coste es idéntico al de web_search: $5 por cada 1.000 llamadas.
  • Ambas herramientas pueden activarse simultáneamente para una cobertura completa.
  • La comprensión de vídeo es exclusiva de x_search (no está disponible en web_search).