Suodata käyttäjätunnuksilla ja päivämäärillä X:ssä
Tällä sivulla
Kohdenna X-hakusi tarkasti
X Search tuottaa todellista arvoa, kun hallitset sen suodatusparametrit. Raakasyötteen sijaan voit kohdistaa hakusi tietyille tileille, asettaa tarkkoja aikavälejä ja sulkea pois häiriötekijöitä. Nämä suodattimet muuttavat yleiskäyttöisen hakutyökalun tarkaksi seurantajärjestelmäksi.
Suodatus käyttäjätunnuksilla: allowed_x_handles ja excluded_x_handles
Tarkkaile tiettyjä tilejä
Parametri allowed_x_handles rajoittaa haun vain niiden tilien julkaisemiin viesteihin, jotka luetlet. Voit kohdistaa hakuun enintään 10 käyttäjätunnusta samanaikaisesti:
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"
]
}]
)
Sulje pois häiritsevät tilit
Parametri excluded_x_handles toimii päinvastoin. Se sallii kaikki tilit paitsi ne, jotka määrität. Tämä on hyödyllistä bottien tai epäolennaisen sisällön tuottajien karsimiseen:
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"]
}]
)
Keskinäisen poissulkevuuden sääntö
Kuten verkkotunnusten kohdalla, myös allowed_x_handles ja excluded_x_handles ovat keskinäisesti poissulkevia. Et voi yhdistää niitä samaan pyyntöön. Raja on 10 käyttäjätunnusta parametria kohden, mikä on kaksinkertainen määrä verkkotunnuksiin verrattuna.
Suodatus päivämäärillä: from_date ja to_date
Aikaparametrien avulla voit määrittää tarkan hakuvälin ISO 8601 -muodossa (VVVV-KK-PP):
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"
}]
)
Nämä suodattimet ovat erityisen hyödyllisiä seuraaviin tarkoituksiin:
- Tapahtuman vaikutusten analysointi: määritä jakso tapahtuman ympärille
- Tunneanalyysin vertailu ennen/jälkeen: suorita kaksi kyselyä eri aikaväleillä
- Vanhan hälyn välttäminen: keskity viimeaikaisiin keskusteluihin
Käyttö natiivin Python SDK:n kanssa
xAI SDK hyväksyy Pythonin datetime-olioita ISO-merkkijonojen lisäksi:
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-käytäntö JavaScriptissä
Vercel AI SDK käyttää parametrien nimissä camelCase-käytäntöä:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Suodattimien yhdistäminen
Voit yhdistää käyttäjätunnukset ja päivämäärät samaan pyyntöön saavuttaaksesi maksimaalisen tarkkuuden:
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"
}]
)
Rakenna dynaaminen seurantajärjestelmä
Yhdistämällä nämä suodattimet ohjelmallisesti voit rakentaa muokattavan seurantasyökalun:
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")
}
# Seuraa tekoälyjohtajia viikon ajan
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Harjoitus
Määritä kohdennettu X-haku 3–5 alasi vaikuttajatilille. Aseta yhden viikon aikaväli ja vertaa tuloksia hakuun, jossa ei ole käyttäjätunnussuodattimia. Mittaa osuvuudessa tapahtunutta muutosta.
Keskeiset asiat
allowed_x_handlesjaexcluded_x_handlessuodattavat tileittäin (maksimi 10 kumpaakin)- Molemmat käyttäjätunnusparametrit ovat keskinäisesti poissulkevia
from_datejato_datemäärittävät aikavälin muodossaVVVV-KK-PP- Päivämäärät voidaan yhdistää käyttäjätunnussuodattimiin
- Python SDK hyväksyy
datetime-olioita, kun taas JavaScript SDK käyttää camelCase-muotoa - Nämä suodattimet muuttavat X Searchin yleiskäyttöisestä työkalusta kohdennetuksi seurantajärjestelmäksi