Filtriranje po datumu
Na ovoj stranici
Definiranje vremenskog okvira pretraživanja
X Search nudi značajku koju Web Search nema: filtriranje po datumu. Možeš definirati određeno razdoblje kako bi ograničio rezultate na objave objavljene unutar tog vremenskog okvira. Ovo je moćan alat za analizu trendova, praćenje događaja i ciljani monitoring.
Parametri datuma
Dva parametra kontroliraju vremenski okvir:
from_date: početni datum pretraživanja (uključivo)to_date: završni datum pretraživanja (uključivo)
Oba su opcionalna i neovisna. Možeš koristiti jedno bez drugoga:
- samo
from_date: sve objave od tog datuma nadalje - samo
to_date: sve objave do tog datuma - oba zajedno: objave unutar definiranog prozora
Format datuma
Datumi slijede format ISO 8601: YYYY-MM-DD (godina-mjesec-dan).
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"
}]
)
Ovaj upit pretražuje samo objave objavljene u ožujku 2026.
Sintaksa SDK-a
xAI SDK (Python)
Python SDK prihvaća i nizove znakova (stringove) i objekte datetime:
from xai_sdk.tools import x_search
import datetime
# Korištenje nizova znakova
tools=[x_search(
from_date="2026-01-01",
to_date="2026-04-01"
)]
# Korištenje objekata datetime
tools=[x_search(
from_date=datetime.datetime(2026, 1, 1),
to_date=datetime.datetime(2026, 4, 1)
)]
Korištenje objekata datetime poželjno je u proizvodnji jer ti omogućuje dinamičko izračunavanje datuma (na primjer, „posljednjih 7 dana“).
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"
})]
Konvencija camelCase: fromDate i toDate.
Kombiniranje datuma i korisničkih imena
Kombiniranje filtriranja po vremenu s filtriranjem po korisničkim imenima posebno je moćno:
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"
}]
)
Ovaj upit kombinira tri filtra: samo objave sa službenih xAI računa i samo one iz travnja 2026.
Slučajevi uporabe
Analiza događaja
Prati reakcije u stvarnom vremenu tijekom događaja (konferencija, lansiranje proizvoda, najava):
# Reakcije tijekom ključnog govora
tools=[{
"type": "x_search",
"from_date": "2026-03-25",
"to_date": "2026-03-26"
}]
Automatizirani tjedni monitoring
Izradi automatsko izvješće o monitoringu za protekli tjedan:
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")
}]
Analiza trendova
Usporedi rasprave o temi u različitim razdobljima slanjem više zahtjeva s različitim vremenskim okvirima.
Najbolje prakse
Iskustvo pokazuje da kraći vremenski okviri daju najbolje rezultate: razdoblje od jednog do sedam dana daje znatno preciznije rezultate od cijelog mjeseca, gdje se važne objave gube u volumenu podataka. U proizvodnji nikada nemoj hardkodirati ove datume – izračunavaj ih pomoću datetime pri svakom pokretanju. Inače će tvoj prozor za „7-dnevni monitoring“ zauvijek upitivati isti tjedan od trenutka implementacije. Naposljetku, vremenski okvir samo definira skup rezultata: upit (prompt) diktira što s njima učiniti. Preciziraj što očekuješ – „sažetak trendova“, „najangažiranije objave“, „glavne najave“ – i model će accordingly filtrirati rezultate umjesto da vraća sve.
Ključne točke
from_dateito_dateu formatu ISO 8601 (YYYY-MM-DD)- Oba parametra su opcionalna i neovisna
- Kombiniraj s filtriranjem po korisničkim imenima za izrazito ciljane pretrage
- Python SDK prihvaća i nizove znakova i objekte
datetime - Ekskluzivno za X Search – Web Search ne nudi filtriranje po vremenu