Filtrering efter dato
På denne side
Definer søgetidsrummet
X Search tilbyder en funktion, som Web Search ikke har: filtrering efter dato. Du kan definere en specifik periode for at begrænse resultaterne til opslag, der er offentliggjort inden for dette tidsrum. Det er et kraftfuldt værktøj til trendanalyse, begivenhedssporing og målrettet overvågning.
Datoparametre
To parametre styrer tidsvinduet:
from_date: startdato for søgningen (inklusiv)to_date: slutdato for søgningen (inklusiv)
Begge er valgfrie og uafhængige. Du kan bruge den ene uden den anden:
- Kun
from_date: alle opslag siden denne dato - Kun
to_date: alle opslag frem til denne dato - Begge sammen: opslag inden for det definerede vindue
Datoformat
Datoer følger formatet ISO 8601: YYYY-MM-DD (år-måned-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"
}]
)
Denne forespørgsel søger kun efter opslag offentliggjort i marts 2026.
SDK-syntaks
xAI SDK (Python)
Python SDK accepterer både strenge og datetime-objekter:
from xai_sdk.tools import x_search
import datetime
# Brug af strenge
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Brug af datetime-objekter
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Brug af datetime-objekter foretrækkes i produktion, da det giver dig mulighed for at beregne datoer dynamisk (f.eks. „de sidste 7 dage”).
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-konvention: fromDate og toDate.
Kombinér datoer og handles
Kombination af tidsfiltrering med filtrering på handles er særligt kraftfuld:
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"
}]
)
Denne forespørgsel kombinerer tre filtre: kun opslag fra officielle xAI-konti, og kun i april 2026.
Use cases
Begivenhedsanalyse
Spor reaktioner i realtid under en begivenhed (konference, produktlancering, annoncering):
# Reaktioner under en keynote
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Automatiseret ugentlig overvågning
Opret en automatisk overvågningsrapport for den forgangne uge:
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
Sammenlign diskussioner om et emne på forskellige tidspunkter ved at foretage flere forespørgsler med forskellige tidsvinduer.
Bedste praksis
Erfaring viser, at kortere vinduer fungerer bedst: en periode på én til syv dage giver væsentligt mere præcise resultater end en hel måned, hvor vigtige opslag går tabt i mængden. I produktion må du aldrig hardkode disse datoer – beregn dem med datetime ved hver kørsel. Ellers vil dit „7-dages overvågnings”-vindue altid forespørge den samme uge fra deploymentstidspunktet. Endelig definerer tidsvinduet kun resultatmængden: prompten dikterer, hvad der skal gøres med den. Specificér, hvad du forventer – „trendopsamling”, „mest engagerede opslag”, „vigtige annonceringer” – så vil modellen filtrere resultaterne derefter i stedet for at returnere alt.
Vigtige pointer
from_dateogto_datei ISO 8601-format (YYYY-MM-DD)- Begge parametre er valgfrie og uafhængige
- Kombinér med filtrering på handles for meget målrettede søgninger
- Python SDK accepterer både strenge og
datetime-objekter - Eksklusivt for X Search – Web Search tilbyder ikke tidsfiltrering