X Search za marketing: korisnička imena, datumi i filteri
Na ovoj stranici
Pretvori X u alat za nadzor marketinga
X (bivši Twitter) ostaje jedna od najbogatijih platformi za djelotvorne marketinške podatke u stvarnom vremenu. Pomoću alata x_search u Grok API-ju možeš strukturirano, filtrirano i automatizirano upitovati tu masu informacija izravno iz svojih aplikacija ili skripti.
Za razliku od ručnog pretraživanja na X-u, API ti omogućuje precizno ciljanje određenih računa, razdoblja i tema. Za marketing menadžera to znači prelazak s „obrtničkog“ nadzora na programabilni sustav prikupljanja konkurentske obavještajne službe.
Omogući X Search u Grok API-ju
Alat x_search omogućuješ deklariranjem u polju tools unutar svog API zahtjeva. Radi isključivo na Responses API-ju (stara krajnja točka Chat Completions je zastarjela za pretraživanje).
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 automatski odlučuje kada pokrenuti pretraživanje na X-u na temelju tvog pitanja. Ne moraš ručno upravljati okidačem.
Filtriraj po korisničkim imenima: ciljaj određene račune
Parametar allowed_x_handles omogućuje ti ograničavanje pretraživanja na najviše 10 specifičnih X računa. Ovo je idealan alat za nadzor izravnih konkurenata ili partnera.
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"
]
}]
)
Suprotno tome, excluded_x_handles omogućuje ti isključivanje do 10 računa iz rezultata. Napomena: ova dva parametra su međusobno isključiva (ne možeš ih kombinirati u istom zahtjevu).
Marketinški slučajevi uporabe
- Nadzor konkurencije: prati 5–10 računa svojih izravnih konkurenata
- Partnerstva: prati objave svojih partnera i ambasadora
- Ekosustav: isključi vlastite račune kako bi vidio samo tržište
Filtriraj po datumima: izoliraj razdoblje
Parametri from_date i to_date prihvaćaju datume u ISO 8601 formatu (GGGG-MM-DD). To ti omogućuje ciljanje specifične kampanje, događaja u sektoru ili usporedbu dva razdoblja.
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"
}]
)
Ova kombinacija korisničkih imena i datuma daje ti iznimno precizan opseg pretraživanja, usporediv s automatiziranim briefom za istraživanje tržišta.
Razumijevanje slika i videozapisa u objavama
Dva boolean parametra obogaćuju tvoj vizualni nadzor:
enable_image_understanding: model analizira slike sadržane u objavama (vizuali kampanja, infografike, snimke zaslona)enable_video_understanding: model tumači videozapise (reklamni spotovi, najave proizvoda, demonstracije)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Za marketinškog stručnjaka to znači da Grok može opisati reklamne vizuale tvojih konkurenata, identificirati korištene kolorističke kodove ili sažeti sadržaj promotivnog videozapisa, sve to programski.
Praktični rad: skripta za tjedni nadzor
Evo kompletne skripte koja generira tjedno izvješće o nadzoru tvojih konkurenata:
from datetime import datetime, timedelta
# Izračunaj protekli tjedan
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 točke
- X Search košta 5 USD po 1.000 poziva, što ga čini vrlo pristupačnim alatom za nadzor
- Možeš filtrirati po korisničkim imenima (maks. 10) ili datumima (ISO 8601 format), ili kombinirati oboje
allowed_x_handlesiexcluded_x_handlessu međusobno isključivi- Analiza slika i videozapisa u objavama ekskluzivna je za X Search (nije dostupna na Web Searchu)
- Koristi Responses API (ne Chat Completions, koji je zastario za pretraživanje)