Filtriranje po uporabniških imenih na X
Na tej strani
Ciljanje na določene račune na X
Prav tako kot Iskanje po spletu omogoča filtriranje po domenah, Iskanje po X omogoča filtriranje po računih (uporabniških imenih). Iskanje lahko omejiš na objave določenega niza računov ali pa določene račune iz rezultatov izključiš. To filtriranje je ključno za primere uporabe, kot so spremljanje dogodkov, sledenje blagovni znamki ali analiza vplivnežev.
Dva parametra za filtriranje
Iskanje po X ponuja dva parametra za filtriranje uporabniških imen:
allowed_x_handles: omeji iskanje na objave naštetih računov (dovoljeni seznam)excluded_x_handles: izključi objave naštetih računov (seznam blokiranih)
Tako kot pri Iskanju po spletu sta ta parametra medsebojno izključujoča. V istem zahtevku ne moreš uporabiti obeh hkrati.
Vsak parameter sprejme polje največ 10 uporabniških imen (v primerjavi s 5 domenami pri Iskanju po spletu).
Uporaba allowed_x_handles (dovoljeni seznam)
Ta parameter je idealen za spremljanje komunikacije določenih računov:
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"]
}]
)
Model bo iskal le objave, ki so jih objavili ti računi.
Primeri uporabe dovoljenega seznama
- Konkurenčna obveščenost: spremljaj napovedi svojih konkurentov
- Spremljanje blagovne znamke: sledi svojim uradnim računom in računom svojih ambasadorjev
- Analiza vplivnežev: združi mnenja panela strokovnjakov
- Institucionalno sledenje: spremljaj račune regulatorjev ali uradnih organizacij
Uporaba excluded_x_handles (seznam blokiranih)
Ta parameter ti omogoča izključitev določenih računov, kot so boti ali nepomembni računi:
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"]
}]
)
Primeri uporabe seznama blokiranih
- Izključitev botov: odstrani avtomatizirane račune iz rezultatov
- Izključitev spama: filtriraj račune, znane po vsebinah nizke kakovosti
- Izključitev lastnih računov: analiziraj zunanje odzive brez svojih objav
Sintaksa SDK
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"]
})]
Upoštevaj konvencijo camelCase v JavaScript SDK: allowedXHandles namesto allowed_x_handles.
Najboljše prakse
Izbira med dovoljenim seznamom in seznamom blokiranih
Uporabi dovoljeni seznam, ko imaš določen niz računov in želiš le njihove objave. To je najbolj natančna metoda, ki varčuje z žetoni.
Uporabi seznam blokiranih, ko želiš široko iskanje, vendar ga moraš očistiti z odstranitvijo znanih virov šuma.
Optimizacija števila uporabniških imen
Z omejitvijo 10 uporabniških imen bodi selektiven. Če moraš spremljati več kot 10 računov, svoje zahtevke združi po temah ali izvedi več zaporednih klicev.
Oblika uporabniškega imena
Uporabniška imena ne vključujejo simbola @ (na primer xaboratory). Preveri, ali so uporabniška imena pravilna – napačno črkovano ime bo preprosto vrnilo brez rezultatov za ta račun.
Ključne ugotovitve
- Dva parametra:
allowed_x_handles(dovoljeni seznam) inexcluded_x_handles(seznam blokiranih) - Medsebojno izključujoča: na zahtevek lahko uporabiš le enega
- Največ 10 uporabniških imen na parameter
- Uporabniška imena se pišejo brez simbola
@:"elonmusk", ne"@elonmusk" - Idealno za spremljanje, sledenje blagovni znamki in analizo vplivnežev