Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Suodatus X-käyttäjätunnusten perusteella

Oppitunti 9 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Kohdenna tiettyjä tilejä X:ssä
  2. Kaksi suodatusparametria
  3. allowed_x_handles-parametrin käyttö (sallittujen lista)
  4. excluded_x_handles-parametrin käyttö (estolista)
  5. SDK-syntaksi
  6. Parhaat käytännöt
  7. Keskeiset asiat

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) ja excluded_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