Activar la búsqueda X para investigación en Twitter
En esta página
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.

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.
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()]
});
Combinar web_search y x_search
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_searchse activa con{"type": "x_search"}en el arraytools. - 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 enweb_search).