X Search voor marketing: handles, datums en filters
Op deze pagina
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.
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_handlesenexcluded_x_handleszijn 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)