X Search für Marketing: Handles, Daten und Filter
Auf dieser Seite
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.
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_handlesundexcluded_x_handlessind 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).