Salt la conținutul principal
Română— Alege o limbă
Meniu

Filtrarea după conturi X

Lecția 9 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Vizați conturi specifice pe X
  2. Cei doi parametri de filtrare
  3. Utilizarea allowed_x_handles (listă de permisiuni)
  4. Utilizarea excluded_x_handles (listă de blocare)
  5. Sintaxa SDK
  6. Cele mai bune practici
  7. Puncte cheie

Vizați conturi specifice pe X

La fel cum Căutarea Web vă permite să filtrați după domenii, Căutarea X vă permite să filtrați după conturi (handle-uri). Puteți restricționa căutările la postările provenite de la un set specific de conturi sau puteți exclude anumite conturi din rezultate. Această filtrare este esențială pentru cazuri de utilizare precum monitorizarea, urmărirea brandului sau analiza influencerilor.

Cei doi parametri de filtrare

Căutarea X oferă doi parametri pentru filtrarea după handle-uri:

  • allowed_x_handles: limitează căutarea la postările conturilor listate (listă de permisiuni)
  • excluded_x_handles: exclude postările conturilor listate (listă de blocare)

La fel ca în cazul Căutării Web, acești parametri sunt exclusivi reciproc. Nu puteți utiliza ambii parametri în aceeași cerere.

Fiecare parametru acceptă un tablou de maximum 10 handle-uri (comparativ cu 5 domenii pentru Căutarea Web).

Utilizarea allowed_x_handles (listă de permisiuni)

Acest parametru este ideal pentru monitorizarea comunicărilor provenite de la conturi specifice:

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"]
    }]
)

Modelul va căuta doar postările publicate de aceste conturi.

Cazuri de utilizare pentru lista de permisiuni

  • Informații competitive: monitorizați anunțurile concurenților dumneavoastră
  • Monitorizarea brandului: urmăriți conturile oficiale și pe cele ale ambasadorilor dumneavoastră
  • Analiza influencerilor: agregați opiniile unui panel de experți
  • Urmărire instituțională: urmăriți conturile regulatorilor sau ale organizațiilor oficiale

Utilizarea excluded_x_handles (listă de blocare)

Acest parametru vă permite să excludeți anumite conturi, cum ar fi boții sau conturile irelevante:

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"]
    }]
)

Cazuri de utilizare pentru lista de blocare

  • Excluderea boților: eliminați conturile automate din rezultate
  • Excluderea spam-ului: filtrați conturile cunoscute pentru conținut de calitate scăzută
  • Excluderea propriilor conturi: analizați reacțiile externe fără a include propriile postări

Sintaxa 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"]
})]

Rețineți convenția camelCase în SDK-ul JavaScript: allowedXHandles în loc de allowed_x_handles.

Cele mai bune practici

Alegerea între lista de permisiuni și lista de blocare

Utilizați lista de permisiuni atunci când aveți un set definit de conturi și doriți doar postările acestora. Aceasta este metoda cea mai precisă și eficientă din punct de vedere al token-urilor.

Utilizați lista de blocare atunci când doriți o căutare largă, dar trebuie să o curățați eliminând sursele de zgomot cunoscute.

Optimizarea numărului de handle-uri

Cu o limită de 10 handle-uri, fiți selectivi. Dacă trebuie să monitorizați mai mult de 10 conturi, grupați cererile pe subiecte sau efectuați mai multe apeluri secvențiale.

Formatul handle-ului

Handle-urile nu includ simbolul @ (de exemplu, xaboratory). Verificați dacă handle-urile sunt corecte; un handle scris greșit nu va returna pur și simplu niciun rezultat pentru acel cont.

Puncte cheie

  • Doi parametri: allowed_x_handles (listă de permisiuni) și excluded_x_handles (listă de blocare)
  • Exclusivi reciproc: doar unul câte unul per cerere
  • Maximum 10 handle-uri per parametru
  • Handle-urile se scriu fără @: "elonmusk", nu "@elonmusk"
  • Ideal pentru monitorizare, urmărirea brandului și analiza influencerilor