X-sökning för marknadsföring: Användarnamn, datum och filter
På denna sida
Gör X till ett verktyg för marknadsövervakning
X (tidigare Twitter) är fortfarande en av de rikaste plattformarna för handlingsbar marknadsföringsdata i realtid. Med verktyget x_search i Grok API kan du fråga denna informationsmassa på ett strukturerat, filtrerat och automatiserbart sätt, direkt från dina applikationer eller skript.
Till skillnad från manuell sökning på X låter API:t dig måla in specifika konton, tidsperioder och ämnen med precision. För en marknadsansvarig innebär detta att du går från hantverksmässig övervakning till ett programmerbart system för insamling av konkurrensintelligens.
Aktivera X-sökning i Grok API
Du aktiverar verktyget x_search genom att deklarera det i tools-arrayen i din API-förfrågan. Det fungerar uteslutande med Responses API (den äldre ändpunkten Chat Completions är avskriven för sökning).
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 beslutar automatiskt när den ska starta en sökning på X baserat på din fråga. Du behöver inte hantera utlösningen manuellt.
Filtrera efter användarnamn: Måla in specifika konton
Parametern allowed_x_handles låter dig begränsa sökningen till maximalt 10 specifika X-konton. Detta är det ideala verktyget för att övervaka dina direkta konkurrenter eller partners.
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"
]
}]
)
Omvänt låter excluded_x_handles dig exkludera upp till 10 konton från resultaten. Observera: dessa två parametrar är ömsesidigt uteslutande (du kan inte kombinera dem i samma förfrågan).
Användningsområden inom marknadsföring
- Konkurrensbevakning: spåra de 5–10 konton som tillhör dina direkta konkurrenter
- Partnerskap: följ inlägg från dina partners och ambassadörer
- Ekosystem: exkludera dina egna konton för att bara se marknaden
Filtrera efter datum: Isolera en tidsperiod
Parametrarna from_date och to_date accepterar datum i ISO 8601-format (ÅÅÅÅ-MM-DD). Detta låter dig måla in en specifik kampanj, en branschevent eller jämföra två 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"
}]
)
Denna kombination av användarnamn och datum ger dig ett extremt precist sökomfång, jämförbart med en automatiserad marknadsundersökningsbrief.
Förstå bilder och videor i inlägg
Två booleska parametrar berikar din visuella övervakning:
enable_image_understanding: modellen analyserar bilder som finns i inlägg (kampanjvisualiseringar, infografik, skärmdumpar)enable_video_understanding: modellen tolkar videor (reklamfilmer, produktteasers, demonstrationer)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
För en marknadsförare innebär detta att Grok kan beskriva dina konkurrenters reklamvisualiseringar, identifiera använda färgkoder eller sammanfatta innehållet i en reklamvideo, allt programmerat.
Praktiskt exempel: Skript för veckovis övervakning
Här är ett komplett skript som genererar en veckovis övervakningsrapport om dina konkurrenter:
from datetime import datetime, timedelta
# Beräkna den senaste veckan
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)
Viktiga punkter
- X-sökning kostar 5 USD per 1 000 anrop, vilket gör det till ett mycket prisvärt övervakningsverktyg
- Du kan filtrera efter användarnamn (max 10) eller datum (ISO 8601-format), eller kombinera båda
allowed_x_handlesochexcluded_x_handlesär ömsesidigt uteslutande- Bild- och videoanalys i inlägg är exklusivt för X-sökning (inte tillgängligt i webbsökning)
- Använd Responses API (inte Chat Completions, som är avskriven för sökning)