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

Búsqueda en X para marketing: identificadores, fechas y filtros

Lección 1 de 12 Actualizado el 30 de julio de 2026 Intermedio
En esta página
  1. Convierte X en una herramienta de monitorización de marketing
  2. Habilita la búsqueda en X en la API de Grok
  3. Filtra por identificadores: apunta a cuentas específicas
  4. Filtra por fechas: aísla un periodo
  5. Comprende las imágenes y vídeos de las publicaciones
  6. Práctica: script de monitorización semanal
  7. 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.

$5
por cada 1.000 llamadas
10
identificadores filtrables
ISO
formato de fecha
API
Solo respuestas

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_handles y excluded_x_handles son 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)