Filteren op X-handles
Op deze pagina
Specifieke accounts op X targeten
Net zoals Web Search u laat filteren op domeinen, kunt u met X Search filteren op accounts (handles). U kunt zoekopdrachten beperken tot berichten van een specifieke set accounts, of bepaalde accounts uitsluiten van de resultaten. Deze filtering is essentieel voor use cases zoals monitoring, merktracking of influencer-analyse.
De twee filterparameters
X Search biedt twee parameters voor het filteren op handles:
allowed_x_handles: beperkt de zoekopdracht tot berichten van de vermelde accounts (allowlist)excluded_x_handles: sluit berichten van de vermelde accounts uit (blocklist)
Net als bij Web Search zijn deze parameters wederzijds uitsluitend. U kunt ze niet beide in hetzelfde verzoek gebruiken.
Elke parameter accepteert een array van maximaal 10 handles (in vergelijking met 5 domeinen voor Web Search).
allowed_x_handles gebruiken (allowlist)
Deze parameter is ideaal voor het monitoren van communicatie van specifieke accounts:
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"]
}]
)
Het model zoekt alleen naar berichten die door deze accounts zijn gepubliceerd.
Use cases voor allowlists
- Concurrentie-inlichtingen: monitor aankondigingen van uw concurrenten
- Merkmonitoring: volg uw officiële accounts en die van uw ambassadeurs
- Influencer-analyse: aggregeer opinies van een panel van experts
- Institutionele tracking: volg accounts van toezichthouders of officiële organisaties
excluded_x_handles gebruiken (blocklist)
Met deze parameter kunt u bepaalde accounts uitsluiten, zoals bots of irrelevante accounts:
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"]
}]
)
Use cases voor blocklists
- Bots uitsluiten: verwijder geautomatiseerde accounts uit de resultaten
- Spam uitsluiten: filter accounts die bekend staan om inhoud van lage kwaliteit
- Eigen accounts uitsluiten: analyseer externe reacties zonder uw eigen berichten
SDK-syntax
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"]
})]
Let op de camelCase-conventie in de JavaScript SDK: allowedXHandles in plaats van allowed_x_handles.
Best practices
Kiezen tussen allowlist en blocklist
Gebruik de allowlist wanneer u een gedefinieerde set accounts heeft en alleen hun berichten wilt. Dit is de meest nauwkeurige en token-efficiënte methode.
Gebruik de blocklist wanneer u een brede zoekopdracht wilt uitvoeren, maar deze moet opschonen door bekende ruisbronnen te elimineren.
Het aantal handles optimaliseren
Met een limiet van 10 handles moet u selectief zijn. Als u meer dan 10 accounts moet monitoren, groepeer uw verzoeken dan per onderwerp of voer meerdere opeenvolgende calls uit.
Handle-formaat
Handles bevatten geen @-symbool (bijvoorbeeld xaboratory). Controleer of de handles correct zijn; een verkeerd gespeld handle levert simpelweg geen resultaten op voor dat account.
Belangrijkste punten
- Twee parameters:
allowed_x_handles(allowlist) enexcluded_x_handles(blocklist) - Wederzijds uitsluitend: slechts één per verzoek
- Maximum 10 handles per parameter
- Handles worden geschreven zonder de
@:"elonmusk", niet"@elonmusk" - Ideaal voor monitoring, merktracking en influencer-analyse