Iskanje X za marketing: uporabniška imena, datumi in filtri
Na tej strani
Spremeni X v orodje za nadzor trženja
X (nekdanji Twitter) ostaja ena najbogatejših platform za pridobivanje uporabnih trženjskih podatkov v realnem času. Z orodjem x_search v API-ju Grok lahko to množico informacij poizveduješ strukturirano, filtrirano in avtomatizirano, neposredno iz svojih aplikacij ali skript.
Za razliko od ročnega iskanja na X ti API omogoča natančno ciljanje določenih računov, obdobij in tem. Za vodjo trženja to pomeni prehod od obrtniškega nadzora k programirljivemu sistemu zbiranja konkurenčnih obveščevalnih podatkov.
Omogoči iskanje X v API-ju Grok
Orodje x_search omogočiš tako, da ga deklariraš v polju tools svoje zahteve API. Deluje izključno z API-jem Responses (stara končna točka Chat Completions je za iskanje zastarela).
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"}]
)
Model samodejno odloči, kdaj sprožiti iskanje po X na podlagi tvojega vprašanja. Sprožitve ni treba ročno upravljati.
Filtriraj po uporabniških imenih: ciljanje določenih računov
Parameter allowed_x_handles ti omogoča omejitev iskanja na največ 10 določenih računov X. To je idealno orodje za nadzor tvojih neposrednih konkurentov ali partnerjev.
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"
]
}]
)
Nasprotno parameter excluded_x_handles omogoča izključitev do 10 računov iz rezultatov. Opomba: ta dva parametra sta medsebojno izključujoča (v isti zahtevi ju ne moreš združiti).
Primeri uporabe v marketingu
- Nadzor konkurence: sledi 5–10 računom tvojih neposrednih konkurentov
- Partnerstva: spremljaj objave svojih partnerjev in ambasadorjev
- Ekosistem: izključi svoje račune, da vidiš samo trg
Filtriraj po datumih: izolacija obdobja
Parametra from_date in to_date sprejemata datuma v formatu ISO 8601 (LLLL-MM-DD). To ti omogoča ciljanje specifične kampanje, dogodka v sektorju ali primerjavo dveh obdobij.
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"
}]
)
Ta kombinacija uporabniških imen in datumov ti zagotavlja izjemno natančen obseg iskanja, primerljiv z avtomatiziranim briefom za tržne raziskave.
Razumevanje slik in videoposnetkov v objavah
Dva boolova parametra obogatita tvoj vizualni nadzor:
enable_image_understanding: model analizira slike, vsebovane v objavah (vizuali kampanj, infografike, posnetki zaslona)enable_video_understanding: model interpretira videoposnetke (oglaševalski spoti, napovedniki izdelkov, demonstracije)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Za marketinškega strokovnjaka to pomeni, da lahko Grok programsko opiše oglaševalske vizuale tvojih konkurentov, identificira uporabljene barvne kode ali povzame vsebino promocijskega videoposnetka.
Praktični primer: skripta za tedenski nadzor
Tukaj je celovita skripta, ki ustvari tedensko poročilo o nadzoru tvojih konkurentov:
from datetime import datetime, timedelta
# Izračun preteklega tedna
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)
Ključne ugotovitve
- Iskanje X stane 5 $ na 1.000 klicev, kar ga dela za zelo dostopno orodje za nadzor
- Filtriraš lahko po uporabniških imenih (največ 10) ali datumih (format ISO 8601) ali pa oboje združiš
allowed_x_handlesinexcluded_x_handlessta medsebojno izključujoča- Analiza slik in videoposnetkov v objavah je ekskluzivna za iskanje X (ni na voljo pri spletnem iskanju)
- Uporabi API Responses (ne Chat Completions, ki je za iskanje zastarel)