Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Filteren op X-handles

Les 9 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Specifieke accounts op X targeten
  2. De twee filterparameters
  3. allowed_x_handles gebruiken (allowlist)
  4. excluded_x_handles gebruiken (blocklist)
  5. SDK-syntax
  6. Best practices
  7. Belangrijkste punten

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