Filteren op handles en datums op X
Op deze pagina
Richt uw X-zoekopdrachten nauwkeurig
X Search levert pas echte waarde op zodra u de filterparameters onder de knie heeft. In plaats van een ruwe feed van berichten op te halen, kunt u specifieke accounts targeten, precieze tijdvensters instellen en ruisbronnen uitsluiten. Deze filters transformeren een algemeen zoekinstrument in een precisie-instrument voor monitoring.
Filteren op handles: allowed_x_handles en excluded_x_handles
Specifieke accounts monitoren
De parameter allowed_x_handles beperkt de zoekopdracht tot berichten die zijn gepubliceerd door de accounts die u opgeeft. U kunt maximaal 10 handles tegelijk targeten:
response = client.responses.create(
model="grok-4.5",
input="Summary of recent announcements from these tech accounts",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"elonmusk",
"sama",
"demishassabis",
"ylecun"
]
}]
)
Ruisvolle accounts uitsluiten
De parameter excluded_x_handles werkt omgekeerd. Hiermee staan alle accounts toe behalve die u opgeeft. Handig om bots of accounts met irrelevante inhoud te elimineren:
response = client.responses.create(
model="grok-4.5",
input="Serious discussions on AI regulation",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_spam_1", "compte_parodie"]
}]
)
Regel van wederzijdse uitsluiting
Net als bij webdomeinen zijn allowed_x_handles en excluded_x_handles wederzijds uitsluitend. U kunt ze niet combineren in één enkele aanroep. De limiet is 10 handles per parameter, het dubbele van de limiet voor webdomeinen.
Filteren op datums: from_date en to_date
Met tijdparameters definieert u een nauwkeurig zoekvenster in ISO 8601-indeling (YYYY-MM-DD):
response = client.responses.create(
model="grok-4.5",
input="Reactions to the Grok 4.5 announcement",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-15"
}]
)
Deze filters zijn vooral nuttig voor:
- Analyseren van de impact van een gebeurtenis: definieer de periode rond de gebeurtenis
- Vergelijken van sentiment voor/na: voer twee query’s uit met verschillende vensters
- Vermijden van oudere ruis: focus op recente discussies
Gebruik met de native Python SDK
De xAI SDK accepteert naast ISO-tekenreeksen ook Python datetime-objecten:
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-conventie in JavaScript
De Vercel AI SDK gebruikt de camelCase-conventie voor parameternamen:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Filters combineren
U kunt handles en datums in één enkele aanroep combineren voor maximale precisie:
response = client.responses.create(
model="grok-4.5",
input="What did Sam Altman say about GPT-5 in March 2026?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["sama"],
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Bouw een dynamisch monitorsysteem
Door deze filters programmatisch te combineren, bouwt u een configureerbare monitoringtool:
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")
}
# Monitor AI leaders for the week
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Oefening
Configureer een gerichte X-zoekopdracht voor 3 tot 5 invloedrijke accounts in uw sector. Stel een tijdvenster van één week in en vergelijk de resultaten met een zoekopdracht zonder handle-filters. Meet het verschil in relevantie.
Belangrijkste punten
allowed_x_handlesenexcluded_x_handlesfilteren op account (maximaal 10 elk)- Beide handle-parameters sluiten elkaar wederzijds uit
from_dateento_datedefiniëren het tijdvenster inYYYY-MM-DD-indeling- Datums zijn combineerbaar met handle-filters
- De Python SDK accepteert
datetime-objecten, de JavaScript SDK gebruikt camelCase - Deze filters transformeren X Search van een algemeen instrument in een gericht monitoringinstrument