Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

X Search für Marketing: Handles, Daten und Filter

Lektion 1 von 12 Aktualisiert am 30. Juli 2026 Mittelstufe
Auf dieser Seite
  1. X als Marketing-Monitoring-Tool nutzen
  2. X Search in der Grok-API aktivieren
  3. Filterung nach Handles: Spezifische Konten targetieren
  4. Filterung nach Daten: Isolierung eines Zeitraums
  5. Verständnis von Post-Bildern und Videos
  6. Praxisbeispiel: Skript für wöchentliches Monitoring
  7. Kernaussagen

X als Marketing-Monitoring-Tool nutzen

X (ehemals Twitter) bleibt eine der reichhaltigsten Plattformen für handlungsorientierte Marketingdaten in Echtzeit. Mit dem x_search-Tool in der Grok-API können Sie diese Informationsmasse strukturiert, gefiltert und automatisiert direkt aus Ihren Anwendungen oder Skripten abfragen.

Im Gegensatz zur manuellen Suche auf X ermöglicht die API das präzise Targetieren spezifischer Konten, Zeiträume und Themen. Für einen Marketingmanager bedeutet dies den Übergang von handwerklichem Monitoring zu einem programmierbaren System zur Sammlung von Wettbewerbsintelligenz.

$5
pro 1.000 Aufrufe
10
filterbare Handles
ISO
Datumsformat
API
Nur Antworten

X Search in der Grok-API aktivieren

Sie aktivieren das x_search-Tool, indem Sie es im tools-Array Ihrer API-Anfrage deklarieren. Es funktioniert ausschließlich über die Responses-API (das veraltete Endpunkt für Chat-Completions ist für Suchanfragen nicht mehr verfügbar).

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="Welche neuesten Beiträge von @nike gibt es zu ihren Marketingkampagnen?",
    tools=[{"type": "x_search"}]
)

Das Modell entscheidet automatisch, wann eine Suche auf X basierend auf Ihrer Frage gestartet werden soll. Sie müssen den Auslöser nicht manuell verwalten.

Filterung nach Handles: Spezifische Konten targetieren

Der Parameter allowed_x_handles ermöglicht es Ihnen, die Suche auf maximal 10 spezifische X-Konten zu beschränken. Dies ist das ideale Werkzeug, um Ihre direkten Wettbewerber oder Partner zu überwachen.

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Fassen Sie die Produktankündigungen dieser Marken in dieser Woche zusammen",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "nike", "adidas", "puma",
            "newbalance", "reebok"
        ]
    }]
)

Umgekehrt ermöglicht excluded_x_handles das Ausschluss von bis zu 10 Konten aus den Ergebnissen. Hinweis: Diese beiden Parameter sind gegenseitig ausschließend (Sie können sie nicht in derselben Anfrage kombinieren).

Marketing-Anwendungsfälle

  • Wettbewerbsmonitoring: Überwachen Sie die 5–10 Konten Ihrer direkten Wettbewerber.
  • Partnerschaften: Folgen Sie Beiträgen Ihrer Partner und Botschafter.
  • Ökosystem: Schließen Sie Ihre eigenen Konten aus, um nur den Markt zu sehen.

Filterung nach Daten: Isolierung eines Zeitraums

Die Parameter from_date und to_date akzeptieren Daten im ISO 8601-Format (JJJJ-MM-TT). Dies ermöglicht es Ihnen, eine spezifische Kampagne, ein Branchenevent oder zwei Zeiträume zu vergleichen.

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analysieren Sie die Reaktionen auf die Black-Friday-Kampagne dieser Marken",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["amazon_fr", "cdiscount", "fnac"],
        "from_date": "2025-11-25",
        "to_date": "2025-12-02"
    }]
)

Diese Kombination aus Handles und Daten ergibt einen extrem präzisen Suchbereich, der einem automatisierten Marktforschungsauftrag vergleichbar ist.

Verständnis von Post-Bildern und Videos

Zwei boolesche Parameter bereichern Ihr visuelles Monitoring:

  • enable_image_understanding: Das Modell analysiert Bilder, die in Beiträgen enthalten sind (Kampagnengrafiken, Infografiken, Screenshots).
  • enable_video_understanding: Das Modell interpretiert Videos (Werbespots, Produktvorabsehungen, Demonstrationen).
tools=[{
    "type": "x_search",
    "allowed_x_handles": ["apple"],
    "enable_image_understanding": True,
    "enable_video_understanding": True
}]

Für einen Marketingverantwortlichen bedeutet dies, dass Grok die Werbegrafiken Ihrer Wettbewerber beschreiben, verwendete Farbcodes identifizieren oder den Inhalt eines Werbevideos programmatisch zusammenfassen kann.

Praxisbeispiel: Skript für wöchentliches Monitoring

Hier ist ein vollständiges Skript, das einen wöchentlichen Monitoring-Bericht über Ihre Wettbewerber erstellt:

from datetime import datetime, timedelta

# Berechnung der vergangenen Woche
heute = datetime.now().strftime("%Y-%m-%d")
letzte_woche = (datetime.now() - timedelta(days=7)).strftime("%Y-%m-%d")

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="""Analysieren Sie die Beiträge dieser Marken aus der vergangenen Woche.
    Für jede Marke identifizieren Sie:
    1. Wichtige Produktankündigungen
    2. Startete Marketingkampagnen
    3. Tonfall und Positionierung
    4. Beiträge, die die meisten Interaktionen generiert haben""",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "concurrent1", "concurrent2", "concurrent3"
        ],
        "from_date": letzte_woche,
        "to_date": heute,
        "enable_image_understanding": True
    }]
)

print(response.output_text)

Kernaussagen

  • X Search kostet 5 USD pro 1.000 Aufrufe, was es zu einem sehr erschwinglichen Monitoring-Tool macht.
  • Sie können nach Handles (maximal 10) oder Daten (ISO 8601-Format) filtern oder beides kombinieren.
  • allowed_x_handles und excluded_x_handles sind gegenseitig ausschließend.
  • Die Analyse von Bildern und Videos in Beiträgen ist exklusiv für X Search verfügbar (nicht auf der Websuche).
  • Nutzen Sie die Responses-API (nicht Chat-Completions, die für Suchanfragen veraltet ist).