X-søgning til markedsføring: Brugernavne, datoer og filtre
På denne side
Gør X til et værktøj til markedsføringsovervågning
X (tidligere Twitter) forbliver en af de rigeste platforme for handlingsorienterede markedsføringsdata i realtid. Med værktøjet x_search i Grok API’en kan du forespørge denne informationsmængde på en struktureret, filtreret og automatiserbar måde, direkte fra dine applikationer eller scripts.
I modsætning til manuel søgning på X lader API’en dig målrette specifikke kontoer, perioder og emner præcist. For en marketingansvarlig betyder det at rykke fra håndværksmæssig overvågning til et programmerbart system til indsamling af konkurrenceintelligence.
Aktiver X-søgning i Grok API’en
Du aktiverer værktøjet x_search ved at deklarere det i tools-arrayet i din API-anmodning. Det fungerer udelukkende på Responses API (det ældre Chat Completions-endpoint er udfaset til søgning).
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"}]
)
Modellen beslutter automatisk, hvornår den skal iværksætte en søgning på X baseret på dit spørgsmål. Du behøver ikke styre udløsningen manuelt.
Filtrer efter brugernavne: Målret specifikke kontoer
Parameteren allowed_x_handles lader dig begrænse søgningen til maksimalt 10 specifikke X-kontoer. Dette er det ideelle værktøj til at overvåge dine direkte konkurrenter eller partnere.
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"
]
}]
)
Omvendt lader excluded_x_handles dig ekskludere op til 10 kontoer fra resultaterne. Bemærk: disse to parametre er gensidigt udelukkende (du kan ikke kombinere dem i samme anmodning).
Anvendelsestilfælde inden for markedsføring
- Konkurrentovervågning: Følg de 5–10 kontoer, der tilhører dine direkte konkurrenter
- Partnerskaber: Følg opslag fra dine partnere og ambassadører
- Økosystem: Ekskluder dine egne kontoer for kun at se markedet
Filtrer efter datoer: Isolér en periode
Parametrene from_date og to_date accepterer datoer i ISO 8601-formatet (ÅÅÅÅ-MM-DD). Dette lader dig målrette en specifik kampagne, en begivenhed i branchen eller sammenligne to perioder.
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"
}]
)
Denne kombination af brugernavne + datoer giver dig et ekstremt præcist søgeområde, der kan sammenlignes med et automatiseret markedsresearch-brief.
Forstå billeder og videoer i opslag
To boolske parametre beriger din visuelle overvågning:
enable_image_understanding: Modellen analyserer billeder indeholdt i opslag (kampagnevisuals, infografik, skærmbilleder)enable_video_understanding: Modellen fortolker videoer (reklamespots, produkt-teasere, demonstrationer)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
For en marketingsfolk betyder det, at Grok kan beskrive dine konkurrenters reklamevisuals, identificere brugte farvekoder eller opsummere indholdet af en promotionsvideo, alt sammen programmatisk.
Praktisk øvelse: Script til ugentlig overvågning
Her er et komplet script, der genererer en ugentlig overvågningsrapport om dine konkurrenter:
from datetime import datetime, timedelta
# Beregn den forløbne uge
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)
Vigtige pointer
- X-søgning koster $5 per 1.000 opkald, hvilket gør det til et meget overkommeligt overvågningsværktøj
- Du kan filtrere efter brugernavne (maks. 10) eller datoer (ISO 8601-format) eller kombinere begge
allowed_x_handlesogexcluded_x_handleser gensidigt udelukkende- Billede- og videoanalyse i opslag er eksklusivt for X-søgning (ikke tilgængelig på Web Search)
- Brug Responses API (ikke Chat Completions, som er udfaset til søgning)