Filtern nach X-Konten
Auf dieser Seite
Spezifische Konten auf X gezielt
Genau wie die Websuche nach Domains filtern lässt, ermöglicht die X-Suche das Filtern nach Konten (Handles). Sie können Suchen auf Beiträge aus einem bestimmten Satz von Konten beschränken oder bestimmte Konten aus den Ergebnissen ausschließen. Dieses Filtern ist für Anwendungsfälle wie das Monitoring, die Markenüberwachung oder die Influencer-Analyse unerlässlich.
Die beiden Filterparameter
Die X-Suche bietet zwei Parameter zur Filterung nach Handles:
allowed_x_handles: Beschränkt die Suche auf Beiträge der aufgeführten Konten (Allowlist)excluded_x_handles: Schließt Beiträge der aufgeführten Konten aus (Blocklist)
Wie bei der Websuche sind diese Parameter gegenseitig ausschließend. Sie können beide nicht in derselben Anfrage verwenden.
Jeder Parameter akzeptiert ein Array von bis zu 10 Handles (im Vergleich zu 5 Domains bei der Websuche).
Verwendung von allowed_x_handles (Allowlist)
Dieser Parameter ist ideal für das Monitoring von Kommunikationen aus spezifischen Konten:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Was sind die neuesten Ankündigungen von xAI?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"]
}]
)
Das Modell sucht ausschließlich nach von diesen Konten veröffentlichten Beiträgen.
Anwendungsfälle für die Allowlist
- Wettbewerbsanalyse: Überwachen Sie Ankündigungen Ihrer Wettbewerber
- Markenüberwachung: Verfolgen Sie Ihre offiziellen Konten sowie die Ihrer Botschafter
- Influencer-Analyse: Aggregieren Sie Meinungen aus einem Panel von Experten
- Institutionelles Monitoring: Folgen Sie Konten von Aufsichtsbehörden oder offiziellen Organisationen
Verwendung von excluded_x_handles (Blocklist)
Dieser Parameter ermöglicht es, bestimmte Konten auszuschließen, wie zum Beispiel Bots oder irrelevante Konten:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Was denken Entwickler über die neueste Version von Python?",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_python_news", "spam_account"]
}]
)
Anwendungsfälle für die Blocklist
- Bots ausschließen: Entfernen Sie automatisierte Konten aus den Ergebnissen
- Spam ausschließen: Filtern Sie Konten heraus, die für minderwertige Inhalte bekannt sind
- Eigene Konten ausschließen: Analysieren Sie externe Reaktionen, ohne Ihre eigenen Beiträge einzubeziehen
SDK-Syntax
xAI SDK (Python)
from xai_sdk.tools import x_search
tools=[x_search(
allowed_x_handles=["elonmusk", "xaboratory"]
)]
OpenAI SDK (Python)
tools=[{
"type": "x_search",
"allowed_x_handles": ["elonmusk", "xaboratory"]
}]
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk", "xaboratory"]
})]
Beachten Sie die camelCase-Konvention im JavaScript-SDK: allowedXHandles statt allowed_x_handles.
Best Practices
Auswahl zwischen Allowlist und Blocklist
Verwenden Sie die Allowlist, wenn Sie einen definierten Satz von Konten haben und nur deren Beiträge wünschen. Dies ist die präziseste und token-effizienteste Methode.
Verwenden Sie die Blocklist, wenn Sie eine breite Suche durchführen, aber das Ergebnis durch das Eliminieren bekannter Rauschquellen bereinigen möchten.
Optimierung der Anzahl der Handles
Mit einem Limit von 10 Handles sollten Sie selektiv vorgehen. Wenn Sie mehr als 10 Konten überwachen müssen, gruppieren Sie Ihre Anfragen nach Themen oder führen Sie mehrere aufeinanderfolgende Aufrufe durch.
Handle-Format
Handles enthalten nicht das @-Symbol (zum Beispiel xaboratory). Stellen Sie sicher, dass die Handles korrekt sind – ein falsch geschriebener Handle führt einfach zu keinen Ergebnissen für dieses Konto.
Kernaussagen
- Zwei Parameter:
allowed_x_handles(Allowlist) undexcluded_x_handles(Blocklist) - Gegenseitig ausschließend: Nur einer pro Anfrage
- Maximum 10 Handles pro Parameter
- Handles werden ohne das
@geschrieben:"elonmusk", nicht"@elonmusk" - Ideal für Monitoring, Markenüberwachung und Influencer-Analyse