Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Filteren op handles en datums op X

Les 6 van 14 Bijgewerkt op 30 juli 2026 Beginner
Op deze pagina
  1. Richt uw X-zoekopdrachten nauwkeurig
  2. Filteren op handles: allowed_x_handles en excluded_x_handles
  3. Filteren op datums: from_date en to_date
  4. Filters combineren
  5. Bouw een dynamisch monitorsysteem
  6. Oefening
  7. Belangrijkste punten

Richt uw X-zoekopdrachten nauwkeurig

X Search levert pas echte waarde op zodra u de filterparameters onder de knie heeft. In plaats van een ruwe feed van berichten op te halen, kunt u specifieke accounts targeten, precieze tijdvensters instellen en ruisbronnen uitsluiten. Deze filters transformeren een algemeen zoekinstrument in een precisie-instrument voor monitoring.

Filteren op handles: allowed_x_handles en excluded_x_handles

Specifieke accounts monitoren

De parameter allowed_x_handles beperkt de zoekopdracht tot berichten die zijn gepubliceerd door de accounts die u opgeeft. U kunt maximaal 10 handles tegelijk targeten:

response = client.responses.create(
    model="grok-4.5",
    input="Summary of recent announcements from these tech accounts",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "elonmusk",
            "sama",
            "demishassabis",
            "ylecun"
        ]
    }]
)

Ruisvolle accounts uitsluiten

De parameter excluded_x_handles werkt omgekeerd. Hiermee staan alle accounts toe behalve die u opgeeft. Handig om bots of accounts met irrelevante inhoud te elimineren:

response = client.responses.create(
    model="grok-4.5",
    input="Serious discussions on AI regulation",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_spam_1", "compte_parodie"]
    }]
)

Regel van wederzijdse uitsluiting

Net als bij webdomeinen zijn allowed_x_handles en excluded_x_handles wederzijds uitsluitend. U kunt ze niet combineren in één enkele aanroep. De limiet is 10 handles per parameter, het dubbele van de limiet voor webdomeinen.

Filteren op datums: from_date en to_date

Met tijdparameters definieert u een nauwkeurig zoekvenster in ISO 8601-indeling (YYYY-MM-DD):

response = client.responses.create(
    model="grok-4.5",
    input="Reactions to the Grok 4.5 announcement",
    tools=[{
        "type": "x_search",
        "from_date": "2026-03-01",
        "to_date": "2026-03-15"
    }]
)

Deze filters zijn vooral nuttig voor:

  • Analyseren van de impact van een gebeurtenis: definieer de periode rond de gebeurtenis
  • Vergelijken van sentiment voor/na: voer twee query’s uit met verschillende vensters
  • Vermijden van oudere ruis: focus op recente discussies

Gebruik met de native Python SDK

De xAI SDK accepteert naast ISO-tekenreeksen ook Python datetime-objecten:

from xai_sdk.tools import x_search
from datetime import datetime

response = client.chat.create(
    model="grok-4.5",
    tools=[x_search(
        from_date=datetime(2026, 3, 1),
        to_date=datetime(2026, 3, 31)
    )]
)

camelCase-conventie in JavaScript

De Vercel AI SDK gebruikt de camelCase-conventie voor parameternamen:

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk"],
  fromDate: "2026-03-01",
  toDate: "2026-03-31"
})]

Filters combineren

U kunt handles en datums in één enkele aanroep combineren voor maximale precisie:

response = client.responses.create(
    model="grok-4.5",
    input="What did Sam Altman say about GPT-5 in March 2026?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["sama"],
        "from_date": "2026-03-01",
        "to_date": "2026-03-31"
    }]
)

Bouw een dynamisch monitorsysteem

Door deze filters programmatisch te combineren, bouwt u een configureerbare monitoringtool:

def create_x_monitor(handles, days_back=7):
    from datetime import datetime, timedelta
    today = datetime.now()
    start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")

    return {
        "type": "x_search",
        "allowed_x_handles": handles,
        "from_date": start,
        "to_date": today.strftime("%Y-%m-%d")
    }

# Monitor AI leaders for the week
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Oefening

Configureer een gerichte X-zoekopdracht voor 3 tot 5 invloedrijke accounts in uw sector. Stel een tijdvenster van één week in en vergelijk de resultaten met een zoekopdracht zonder handle-filters. Meet het verschil in relevantie.

Belangrijkste punten

  • allowed_x_handles en excluded_x_handles filteren op account (maximaal 10 elk)
  • Beide handle-parameters sluiten elkaar wederzijds uit
  • from_date en to_date definiëren het tijdvenster in YYYY-MM-DD-indeling
  • Datums zijn combineerbaar met handle-filters
  • De Python SDK accepteert datetime-objecten, de JavaScript SDK gebruikt camelCase
  • Deze filters transformeren X Search van een algemeen instrument in een gericht monitoringinstrument