Suodatus X-käyttäjätunnusten perusteella
Tällä sivulla
Kohdenna tiettyjä tilejä X:ssä
Aivan kuten Web-haku mahdollistaa suodatuksen verkkotunnusten perusteella, X-haku antaa sinun suodattaa tuloksia käyttäjätunnusten (handle) perusteella. Voit rajoittaa haut tiettyjen tilien julkaisemiin viesteihin tai sulkea pois tietyt tilit tuloksista. Tämä suodatus on välttämätöntä esimerkiksi seurantaan, brändin monitorointiin tai vaikuttaja-analyysiin.
Kaksi suodatusparametria
X-haku tarjoaa kaksi käyttäjätunnusten suodatusparametria:
allowed_x_handles: rajoittaa haun listattujen tilien julkaisemiin viesteihin (sallittujen lista)excluded_x_handles: sulkee pois listattujen tilien viestit tuloksista (estolista)
Kuten Web-haussa, nämä parametrit ovat toisensa poissulkevia. Et voi käyttää molempia samassa pyynnössä.
Kumpikin parametri hyväksyy taulukon, jossa on enintään 10 käyttäjätunnusta (verrattuna Web-haun 5 verkkotunnukseen).
allowed_x_handles-parametrin käyttö (sallittujen lista)
Tämä parametri sopii erinomaisesti tiettyjen tilien viestinnän seuraamiseen:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest announcements from xAI?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xaboratory", "xaboratorydev"]
}]
)
Malli hakee vain näiden tilien julkaisemia viestejä.
Sallittujen listan käyttökohteet
- Kilpailija-analyysi: seuraa kilpailijoidesi tiedotteita
- Brändin monitorointi: seuraa virallisia tilejäsi ja lähettiläittesi tilejä
- Vaikuttaja-analyysi: kokoa mielipiteitä asiantuntijapaneelilta
- Institutionaalinen seuranta: seuraa viranomaisten tai virallisten organisaatioiden tilejä
excluded_x_handles-parametrin käyttö (estolista)
Tämän parametrin avulla voit sulkea pois tiettyjä tilejä, kuten botteja tai epäoleellisia tilejä:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What do developers think about the latest version of Python?",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_python_news", "spam_account"]
}]
)
Estolistan käyttökohteet
- Bottien poissulkeminen: poista automatisoidut tilit tuloksista
- Roskapostin suodatus: suodata pois tilit, jotka tunnetaan heikkolaatuisesta sisällöstä
- Omien tilien poissulkeminen: analysoi ulkoisia reaktioita ilman omia julkaisujasi
SDK-syntaksi
xAI SDK (Python)
from xai_sdk.tools import x_search
tools=[x_search(
allowed_x_handles=["elonmusk", "xaboratory"]
)]
OpenAI SDK (Python)
tools=[{
"type": "x_search",
"allowed_x_handles": ["elonmusk", "xaboratory"]
}]
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk", "xaboratory"]
})]
Huomaa camelCase-käytäntö JavaScript-SDK:ssa: allowedXHandles allowed_x_handles-parametrin sijaan.
Parhaat käytännöt
Valinta sallittujen ja estolistojen välillä
Käytä sallittujen listaa, kun sinulla on määritelty joukko tilejä ja haluat vain niiden viestit. Tämä on tarkin ja token-tehokkain menetelmä.
Käytä estolistaa, kun haluat tehdä laajan haun, mutta tarvitset siivousta poistamalla tunnetut häiriölähteet.
Käyttäjätunnusten määrän optimointi
Koska raja on 10 käyttäjätunnusta, ole valikoiva. Jos tarvitset yli 10 tilin seurantaa, ryhmitä pyyntösi aiheittain tai tee useita peräkkäisiä kutsuja.
Käyttäjätunnuksen muoto
Käyttäjätunnukset eivät sisällä @-merkkiä (esimerkiksi xaboratory). Varmista, että tunnukset ovat oikein – väärin kirjoitettu tunnus palauttaa yksinkertaisesti ei tuloksia kyseiselle tilille.
Keskeiset asiat
- Kaksi parametria:
allowed_x_handles(sallittujen lista) jaexcluded_x_handles(estolista) - Toisensa poissulkevat: vain yksi kerrallaan per pyyntö
- Enintään 10 käyttäjätunnusta per parametri
- Käyttäjätunnukset kirjoitetaan ilman
@-merkkiä:"elonmusk", ei"@elonmusk" - Ihanteellinen seurantaan, brändin monitorointiin ja vaikuttaja-analyysiin