Nach Handles und Daten auf X filtern
Auf dieser Seite
Präzise Ihre X-Suchen steuern
Die X-Suche liefert erst dann echten Mehrwert, wenn Sie ihre Filterparameter beherrschen. Anstatt einen rohen Feed an Beiträgen abzurufen, können Sie spezifische Konten ansprechen, präzise Zeitfenster festlegen und Quellen für Rauschen ausschließen. Diese Filter verwandeln ein allgemeines Suchwerkzeug in ein Instrument zur präzisen Überwachung.
Filtern nach Handles: allowed_x_handles und excluded_x_handles
Spezifische Konten überwachen
Der Parameter allowed_x_handles beschränkt die Suche auf Beiträge, die von den von Ihnen aufgeführten Konten veröffentlicht wurden. Sie können bis zu 10 Handles gleichzeitig ansprechen:
response = client.responses.create(
model="grok-4.5",
input="Zusammenfassung der letzten Ankündigungen von diesen Tech-Konten",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"elonmusk",
"sama",
"demishassabis",
"ylecun"
]
}]
)
Rauschende Konten ausschließen
Der Parameter excluded_x_handles funktioniert umgekehrt. Er erlaubt alle Konten außer den von Ihnen angegebenen. Dies ist nützlich, um Bots oder Konten mit irrelevanter Inhalte zu eliminieren:
response = client.responses.create(
model="grok-4.5",
input="Ernstzunehmende Diskussionen zur KI-Regulierung",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_spam_1", "compte_parodie"]
}]
)
Regel der gegenseitigen Ausschließung
Wie bei Web-Domains sind allowed_x_handles und excluded_x_handles gegenseitig ausschließend. Sie können sie in einem einzigen Aufruf nicht kombinieren. Das Limit beträgt 10 Handles pro Parameter, was dem Doppelten des Limits für Web-Domains entspricht.
Filtern nach Daten: from_date und to_date
Zeitparameter ermöglichen es, ein präzises Suchfenster im ISO 8601-Format (YYYY-MM-DD) zu definieren:
response = client.responses.create(
model="grok-4.5",
input="Reaktionen auf die Ankündigung von Grok 4.5",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-15"
}]
)
Diese Filter sind insbesondere nützlich für:
- Auswirkung eines Ereignisses analysieren: definieren Sie den Zeitraum um das Ereignis herum
- Stimmung vor/nachher vergleichen: führen Sie zwei Abfragen mit unterschiedlichen Fenstern durch
- Älteres Rauschen vermeiden: konzentrieren Sie sich auf aktuelle Diskussionen
Verwendung mit dem nativen Python-SDK
Das xAI-SDK akzeptiert Python datetime-Objekte zusätzlich zu ISO-Strings:
from xai_sdk.tools import x_search
from datetime import datetime
response = client.chat.create(
model="grok-4.5",
tools=[x_search(
from_date=datetime(2026, 3, 1),
to_date=datetime(2026, 3, 31)
)]
)
camelCase-Konvention in JavaScript
Das Vercel AI-SDK verwendet die camelCase-Konvention für Parameternamen:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Filter kombinieren
Sie können Handles und Daten in einem einzigen Aufruf kombinieren, um maximale Präzision zu erreichen:
response = client.responses.create(
model="grok-4.5",
input="Was hat Sam Altman über GPT-5 im März 2026 gesagt?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["sama"],
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Ein dynamisches Überwachungssystem erstellen
Indem Sie diese Filter programmatisch kombinieren, können Sie ein konfigurierbares Überwachungswerkzeug erstellen:
def create_x_monitor(handles, days_back=7):
from datetime import datetime, timedelta
today = datetime.now()
start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")
return {
"type": "x_search",
"allowed_x_handles": handles,
"from_date": start,
"to_date": today.strftime("%Y-%m-%d")
}
# Überwachung von KI-Führern für die Woche
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Übung
Konfigurieren Sie eine gezielte X-Suche für 3 bis 5 einflussreiche Konten in Ihrem Sektor. Legen Sie ein Zeitfenster von einer Woche fest und vergleichen Sie die Ergebnisse mit einer Suche ohne Handle-Filter. Messen Sie den Unterschied in der Relevanz.
Kernaussagen
allowed_x_handlesundexcluded_x_handlesfiltern nach Konten (maximal 10 pro Parameter)- Beide Handle-Parameter sind gegenseitig ausschließend
from_dateundto_datedefinieren das Zeitfenster im FormatYYYY-MM-DD- Daten können mit Handle-Filtern kombiniert werden
- Das Python-SDK akzeptiert
datetime-Objekte, das JavaScript-SDK verwendet camelCase - Diese Filter verwandeln die X-Suche von einem allgemeinen Werkzeug in ein gezieltes Überwachungsinstrument