Búsqueda en X para marketing: identificadores, fechas y filtros
En esta página
- Convierte X en una herramienta de monitorización de marketing
- Habilita la búsqueda en X en la API de Grok
- Filtra por identificadores: apunta a cuentas específicas
- Filtra por fechas: aísla un periodo
- Comprende las imágenes y vídeos de las publicaciones
- Práctica: script de monitorización semanal
- Puntos clave
Convierte X en una herramienta de monitorización de marketing
X (anteriormente Twitter) sigue siendo una de las plataformas más ricas en datos de marketing accionables en tiempo real. Con la herramienta x_search de la API de Grok, puedes consultar esta masa de información de forma estructurada, filtrada y automatizable, directamente desde tus aplicaciones o scripts.
A diferencia de la búsqueda manual en X, la API te permite apuntar a cuentas, periodos y temas específicos con precisión. Para un responsable de marketing, esto supone pasar de una monitorización artesanal a un sistema programable de recopilación de inteligencia competitiva.
Habilita la búsqueda en X en la API de Grok
Habilitas la herramienta x_search declarándola en el array tools de tu solicitud a la API. Funciona exclusivamente con la API de Responses (el endpoint heredado de Chat Completions está obsoleto para búsquedas).
from openai import OpenAI
client = OpenAI(
api_key="your-xai-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="¿Cuáles son las últimas publicaciones de @nike sobre sus campañas de marketing?",
tools=[{"type": "x_search"}]
)
El modelo decide automáticamente cuándo lanzar una búsqueda en X basándose en tu pregunta. No necesitas gestionar el desencadenante manualmente.
Filtra por identificadores: apunta a cuentas específicas
El parámetro allowed_x_handles te permite restringir la búsqueda a un máximo de 10 cuentas específicas de X. Esta es la herramienta ideal para monitorizar a tus competidores directos o socios.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Resume los anuncios de producto de estas marcas esta semana",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"nike", "adidas", "puma",
"newbalance", "reebok"
]
}]
)
Por el contrario, excluded_x_handles te permite excluir hasta 10 cuentas de los resultados. Nota: estos dos parámetros son mutuamente excluyentes (no puedes combinarlos en la misma solicitud).
Casos de uso en marketing
- Monitorización competitiva: rastrea las 5–10 cuentas de tus competidores directos
- Asociaciones: sigue las publicaciones de tus socios y embajadores
- Ecosistema: excluye tus propias cuentas para ver solo el mercado
Filtra por fechas: aísla un periodo
Los parámetros from_date y to_date aceptan fechas en formato ISO 8601 (AAAA-MM-DD). Esto te permite apuntar a una campaña específica, un evento del sector o comparar dos periodos.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analiza las reacciones a la campaña del Black Friday de estas marcas",
tools=[{
"type": "x_search",
"allowed_x_handles": ["amazon_fr", "cdiscount", "fnac"],
"from_date": "2025-11-25",
"to_date": "2025-12-02"
}]
)
Esta combinación de identificadores + fechas te ofrece un alcance de búsqueda extremadamente preciso, comparable a un pliego de condiciones de investigación de mercado automatizado.
Comprende las imágenes y vídeos de las publicaciones
Dos parámetros booleanos enriquecen tu monitorización visual:
enable_image_understanding: el modelo analiza las imágenes contenidas en las publicaciones (visuales de campañas, infografías, capturas de pantalla)enable_video_understanding: el modelo interpreta los vídeos (cuñas publicitarias, teasers de productos, demostraciones)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Para un profesional del marketing, esto significa que Grok puede describir los visuales publicitarios de tus competidores, identificar los códigos de color utilizados o resumir el contenido de un vídeo promocional, todo de forma programática.
Práctica: script de monitorización semanal
Aquí tienes un script completo que genera un informe de monitorización semanal sobre tus competidores:
from datetime import datetime, timedelta
# Calcula la semana pasada
today = datetime.now().strftime("%Y-%m-%d")
last_week = (datetime.now() - timedelta(days=7)).strftime("%Y-%m-%d")
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="""Analiza las publicaciones de estas marcas de la última semana.
Para cada marca, identifica:
1. Anuncios importantes de productos
2. Campañas de marketing lanzadas
3. Tono y posicionamiento utilizados
4. Publicaciones que generaron mayor interacción""",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"concurrent1", "concurrent2", "concurrent3"
],
"from_date": last_week,
"to_date": today,
"enable_image_understanding": True
}]
)
print(response.output_text)
Puntos clave
- La búsqueda en X cuesta $5 por cada 1.000 llamadas, lo que la convierte en una herramienta de monitorización muy asequible
- Puedes filtrar por identificadores (máx. 10) o fechas (formato ISO 8601), o combinar ambos
allowed_x_handlesyexcluded_x_handlesson mutuamente excluyentes- El análisis de imágenes y vídeos en publicaciones es exclusivo de la búsqueda en X (no disponible en la búsqueda web)
- Utiliza la API de Responses (no Chat Completions, que está obsoleta para búsquedas)