Datumfiltering
Op deze pagina
Het zoektijdsvenster definiëren
X Search biedt een functie die Web Search niet heeft: datumfiltering. U kunt een specifieke periode definiëren om de resultaten te beperken tot berichten die binnen dat tijdsvenster zijn gepubliceerd. Dit is een krachtig instrument voor trendanalyse, evenementtracking en gerichte monitoring.
Datumparameters
Twee parameters sturen het tijdsvenster aan:
from_date: startdatum van de zoekopdracht (inclusief)to_date: einddatum van de zoekopdracht (inclusief)
Beide zijn optioneel en onafhankelijk van elkaar. U kunt er één gebruiken zonder de andere:
- Alleen
from_date: alle berichten sinds deze datum - Alleen
to_date: alle berichten tot en met deze datum - Beide samen: berichten binnen het gedefinieerde venster
Datumnotatie
Datums volgen de ISO 8601-notatie: YYYY-MM-DD (jaar-maand-dag).
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What were the reactions to the Grok 4 launch?",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Deze query zoekt alleen naar berichten die in maart 2026 zijn gepubliceerd.
SDK-syntax
xAI SDK (Python)
De Python-SDK accepteert zowel strings als datetime-objecten:
from xai_sdk.tools import x_search
import datetime
# Gebruik van strings
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Gebruik van datetime-objecten
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Het gebruik van datetime-objecten heeft de voorkeur in productieomgevingen, omdat u hiermee datums dynamisch kunt berekenen (bijvoorbeeld “de laatste 7 dagen”).
OpenAI SDK (Python)
tools=[{
"type": "x_search",
"from_date": "2026-01-01",
"to_date": "2026-04-01"
}]
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch({
fromDate: "2026-01-01",
toDate: "2026-04-01"
})]
camelCase-conventie: fromDate en toDate.
Datums en handles combineren
Het combineren van tijdfiltering met handle-filtering is bijzonder krachtig:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Summarize xAI's announcements this month",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"],
"from_date": "2026-04-01",
"to_date": "2026-04-30"
}]
)
Deze query combineert drie filters: alleen berichten van officiële xAI-accounts, en alleen in april 2026.
Use cases
Evenementanalyse
Volg reacties in realtime tijdens een evenement (conferentie, productlancering, aankondiging):
# Reacties tijdens een keynote
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Geautomatiseerde wekelijkse monitoring
Maak een automatisch monitoringrapport voor de afgelopen week:
from datetime import datetime, timedelta
today = datetime.now()
week_ago = today - timedelta(days=7)
tools=[{
"type": "x_search",
"from_date": week_ago.strftime("%Y-%m-%d"),
"to_date": today.strftime("%Y-%m-%d")
}]
Trendanalyse
Vergelijk discussies over een onderwerp in verschillende perioden door meerdere verzoeken met verschillende tijdsvensters te doen.
Best practices
Ervaring leert dat kortere vensters het beste werken: een periode van één tot zeven dagen levert aanzienlijk nauwkeurigere resultaten op dan een hele maand, waarbij belangrijke berichten verloren gaan in de hoeveelheid data. Hardcode deze datums in productie nooit; bereken ze bij elke uitvoering met datetime. Anders zal uw “7-daagse monitoring”-venster bij elke implementatie voor altijd dezelfde week bevragen. Tot slot definieert het tijdsvenster alleen de resultatenset: de prompt bepaalt wat ermee gebeurt. Specificeer wat u verwacht—“trendoverzicht”, “berichten met de meeste interactie”, “belangrijke aankondigingen”—en het model zal de resultaten dienovereenkomstig filteren in plaats van alles terug te geven.
Belangrijkste punten
from_dateento_datein ISO 8601-notatie (YYYY-MM-DD)- Beide parameters zijn optioneel en onafhankelijk
- Combineer met handle-filtering voor zeer gerichte zoekopdrachten
- Python-SDK accepteert zowel strings als
datetime-objecten - Exclusief voor X Search—Web Search biedt geen tijdfiltering