Filtrering efter datum
På denna sida
Definiera söktidsfönstret
X Search erbjuder en funktion som Web Search saknar: filtrering efter datum. Du kan definiera en specifik tidsperiod för att begränsa resultaten till inlägg som publicerats inom detta tidsfönster. Detta är ett kraftfullt verktyg för trendanalys, händelseövervakning och målinriktad bevakning.
Datumparametrar
Två parametrar styr tidsfönstret:
from_date: startdatum för sökningen (inkluderande)to_date: slutdatum för sökningen (inkluderande)
Båda är valfria och oberoende av varandra. Du kan använda den ena utan den andra:
- Endast
from_date: alla inlägg sedan detta datum - Endast
to_date: alla inlägg fram till detta datum - Båda tillsammans: inlägg inom det definierade fönstret
Datumformat
Datum följer formatet ISO 8601: YYYY-MM-DD (år-månad-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"
}]
)
Denna fråga söker endast efter inlägg publicerade under mars 2026.
SDK-syntax
xAI SDK (Python)
Python SDK accepterar både strängar och datetime-objekt:
from xai_sdk.tools import x_search
import datetime
# Använda strängar
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Använda datetime-objekt
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Att använda datetime-objekt föredras i produktion eftersom det låter dig beräkna datum dynamiskt (till exempel “de senaste 7 dagarna”).
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"
})]
Konventionen camelCase gäller: fromDate och toDate.
Kombinera datum och konton
Att kombinera tidsfiltrering med filtrering på konton (handles) är särskilt kraftfullt:
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"
}]
)
Denna fråga kombinerar tre filter: endast inlägg från officiella xAI-konton, och endast under april 2026.
Användningsområden
Analys av händelser
Spåra reaktioner i realtid under en händelse (konferens, produktlansering, tillkännagivande):
# Reaktioner under en keynote
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Automatiserad veckovis övervakning
Skapa en automatisk övervakningsrapport för den senaste veckan:
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")
}]
Trendanalys
Jämför diskussioner kring ett ämne vid olika tidpunkter genom att göra flera förfrågningar med distinkta tidsfönster.
Bästa praxis
Erfarenhet visar att kortare tidsfönster fungerar bäst: en period på en till sju dagar ger betydligt mer precisa resultat än en hel månad, där viktiga inlägg riskerar att gå förlorade i volymen. I produktion ska du aldrig hårdkoda dessa datum – beräkna dem med datetime vid varje körning. Annars kommer ditt fönster för “7-dagarsövervakning” att fråga efter samma vecka för evigt från driftsättningen. Slutligen definierar tidsfönstret endast resultatmängden: prompten styr vad som ska göras med den. Specificera vad du förväntar dig – “trendsummering”, “inlägg med mest engagemang”, “viktiga tillkännagivanden” – så filtrerar modellen resultaten därefter istället för att returnera allt.
Viktiga punkter
from_dateochto_datei formatet ISO 8601 (YYYY-MM-DD)- Båda parametrarna är valfria och oberoende
- Kombinera med filtrering på konton för mycket målinriktade sökningar
- Python SDK accepterar både strängar och
datetime-objekt - Exklusivt för X Search – Web Search erbjuder ingen tidsfiltrering