Filtrovanie podľa účtov na X
Na tejto strane
Cielenie na konkrétne účty na X
Rovnako ako webové vyhľadávanie umožňuje filtrovať podľa domén, vyhľadávanie na X ti umožňuje filtrovať podľa účtov (handle). Môžeš obmedziť vyhľadávania na príspevky od konkrétnej množiny účtov alebo určité účty z výsledkov vylúčiť. Toto filtrovanie je nevyhnutné pre prípady použitia, ako je monitorovanie, sledovanie značky alebo analýza influencerov.
Dva parametre filtrovania
Vyhľadávanie na X ponúka dva parametre na filtrovanie podľa účtov:
allowed_x_handles: obmedzuje vyhľadávanie na príspevky od uvedených účtov (povolený zoznam)excluded_x_handles: vylučuje príspevky od uvedených účtov (blokovaný zoznam)
Rovnako ako pri webovom vyhľadávaní sú tieto parametre vzájomne sa vylučujúce. Nemôžeš použiť obe v tej istej požiadavke.
Každý parameter prijíma pole maximálne 10 účtov (v porovnaní s 5 doménami pri webovom vyhľadávaní).
Používanie allowed_x_handles (povolený zoznam)
Tento parameter je ideálny na monitorovanie komunikácie od konkrétnych účtov:
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 bude vyhľadávať iba príspevky zverejnené týmito účtami.
Prípady použitia povoleného zoznamu
- Konkurenčná inteligencia: monitoruj oznámenia svojich konkurentov
- Monitorovanie značky: sleduj svoje oficiálne účty a účty svojich ambasádorov
- Analýza influencerov: agreguj názory od panelu expertov
- Inštitucionálne sledovanie: sleduj účty regulátorov alebo oficiálnych organizácií
Používanie excluded_x_handles (blokovaný zoznam)
Tento parameter ti umožňuje vylúčiť určité účty, ako sú boty alebo irelevantné účty:
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"]
}]
)
Prípady použitia blokovaného zoznamu
- Vylúčenie botov: odstráň automatizované účty z výsledkov
- Vylúčenie spamu: odfiltruj účty známe nízkokvalitným obsahom
- Vylúčenie vlastných účtov: analyzuj externé reakcie bez vlastných príspevkov
Syntax 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"]
})]
Všimni si konvenciu camelCase v JavaScript SDK: allowedXHandles namiesto allowed_x_handles.
Osvedčené postupy
Výber medzi povoleným a blokovaným zoznamom
Použi povolený zoznam, keď máš definovanú množinu účtov a chceš iba ich príspevky. Toto je najpresnejšia a z hľadiska tokenov najefektívnejšia metóda.
Použi blokovaný zoznam, keď chceš široké vyhľadávanie, ale potrebuješ ho vyčistiť odstránením známych zdrojov šumu.
Optimalizácia počtu účtov
Pri limite 10 účtov buď selektívny. Ak potrebuješ monitorovať viac ako 10 účtov, zgrupuj svoje požiadavky podľa témy alebo vykonaj viacero sekvenčných volaní.
Formát účtu
Účty neobsahujú symbol @ (napríklad xaboratory). Over si, či sú účty správne – preklep v účte jednoducho vráti žiadne výsledky pre daný účet.
Kľúčové poznatky
- Dva parametre:
allowed_x_handles(povolený zoznam) aexcluded_x_handles(blokovaný zoznam) - Vzájomne sa vylučujúce: naraz len jeden na požiadavku
- Maximálne 10 účtov na parameter
- Účty sa píšu bez symbolu
@:"elonmusk", nie"@elonmusk" - Ideálne na monitorovanie, sledovanie značky a analýzu influencerov