Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

X Search voor marketing: handles, datums en filters

Les 1 van 12 Bijgewerkt op 30 juli 2026 Gemiddeld
Op deze pagina
  1. Maak van X een marketingmonitoringtool
  2. X Search activeren in de Grok API
  3. Filteren op handles: specifieke accounts targeten
  4. Filteren op datums: een periode isoleren
  5. Afbeeldingen en video’s in posts begrijpen
  6. Praktijk: wekelijks monitoringsscript
  7. Belangrijkste punten

Maak van X een marketingmonitoringtool

X (voorheen Twitter) blijft een van de rijkste platformen voor actuele, direct inzetbare marketingdata. Met de x_search-tool in de Grok API kunt u deze enorme hoeveelheid informatie gestructureerd, gefilterd en automatiseerbaar bevragen, rechtstreeks vanuit uw applicaties of scripts.

In tegenstelling tot handmatig zoeken op X, stelt de API u in staat om specifiek accounts, periodes en onderwerpen te targeten. Voor een marketingmanager betekent dit de overstap van ambachtelijke monitoring naar een programmeerbaar systeem voor concurrentie-informatie.

$5
per 1.000 oproepen
10
filterbare handles
ISO
datumnotatie
API
Alleen Responses

X Search activeren in de Grok API

U activeert de x_search-tool door deze op te nemen in de tools-array van uw API-verzoek. Deze werkt uitsluitend met de Responses API (het verouderde Chat Completions-eindpunt is afgeschreven voor zoekopdrachten).

from openai import OpenAI

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest posts from @nike about their marketing campaigns?",
    tools=[{"type": "x_search"}]
)

Het model bepaalt automatisch wanneer een zoekopdracht op X wordt gestart op basis van uw vraag. U hoeft het activeren niet handmatig te beheren.

Filteren op handles: specifieke accounts targeten

Met de parameter allowed_x_handles beperkt u de zoekopdracht tot maximaal 10 specifieke X-accounts. Dit is de ideale tool om uw directe concurrenten of partners te monitoren.

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Summarize the product announcements from these brands this week",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "nike", "adidas", "puma",
            "newbalance", "reebok"
        ]
    }]
)

Omgekeerd kunt u met excluded_x_handles tot 10 accounts uitsluiten van de resultaten. Let op: deze twee parameters zijn onderling uitsluitend (u kunt ze niet combineren in hetzelfde verzoek).

Toepassingen voor marketing

  • Concurrentiemonitoring: volg de 5–10 accounts van uw directe concurrenten
  • Partnerships: houd posts van uw partners en ambassadeurs in de gaten
  • Ecosysteem: sluit uw eigen accounts uit om alleen de markt te zien

Filteren op datums: een periode isoleren

De parameters from_date en to_date accepteren datums in ISO 8601-notatie (JJJJ-MM-DD). Hiermee richt u zich op een specifieke campagne, een sectorgebeurtenis of vergelijkt u twee periodes.

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze reactions to the Black Friday campaign from these brands",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["amazon_fr", "cdiscount", "fnac"],
        "from_date": "2025-11-25",
        "to_date": "2025-12-02"
    }]
)

Deze combinatie van handles en datums geeft u een uiterst nauwkeurig zoekbereik, vergelijkbaar met een geautomatiseerd marktonderzoeksbrief.

Afbeeldingen en video’s in posts begrijpen

Twee booleaanse parameters verrijken uw visuele monitoring:

  • enable_image_understanding: het model analyseert afbeeldingen in posts (campagnevisuals, infographics, screenshots)
  • enable_video_understanding: het model interpreteert video’s (reclamespots, productteasers, demonstraties)
tools=[{
    "type": "x_search",
    "allowed_x_handles": ["apple"],
    "enable_image_understanding": True,
    "enable_video_understanding": True
}]

Voor een marketeer betekent dit dat Grok de advertentievisuals van uw concurrenten kan beschrijven, gebruikte kleurcodes kan identificeren of de inhoud van een promotievideo kan samenvatten, allemaal programmeerbaar.

Praktijk: wekelijks monitoringsscript

Hieronder vindt u een compleet script dat een wekelijks monitoringrapport over uw concurrenten genereert:

from datetime import datetime, timedelta

# Bereken de afgelopen week
today = datetime.now().strftime("%Y-%m-%d")
last_week = (datetime.now() - timedelta(days=7)).strftime("%Y-%m-%d")

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="""Analyze these brands' posts from the last week.
    For each brand, identify:
    1. Major product announcements
    2. Marketing campaigns launched
    3. Tone and positioning used
    4. Posts that generated the most engagement""",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "concurrent1", "concurrent2", "concurrent3"
        ],
        "from_date": last_week,
        "to_date": today,
        "enable_image_understanding": True
    }]
)

print(response.output_text)

Belangrijkste punten

  • X Search kost $5 per 1.000 oproepen, waardoor het een zeer betaalbare monitoringtool is
  • U kunt filteren op handles (maximaal 10) of datums (ISO 8601-notatie), of beide combineren
  • allowed_x_handles en excluded_x_handles zijn onderling uitsluitend
  • Analyse van afbeeldingen en video’s in posts is exclusief voor X Search (niet beschikbaar bij Web Search)
  • Gebruik de Responses API (niet Chat Completions, dat voor zoeken is afgeschreven)