Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

X Search za marketing: korisnička imena, datumi i filteri

Lekcija 1 od 12 Ažurirano 30. srpnja 2026. Srednja razina
Na ovoj stranici
  1. Pretvori X u alat za nadzor marketinga
  2. Omogući X Search u Grok API-ju
  3. Filtriraj po korisničkim imenima: ciljaj određene račune
  4. Filtriraj po datumima: izoliraj razdoblje
  5. Razumijevanje slika i videozapisa u objavama
  6. Praktični rad: skripta za tjedni nadzor
  7. Ključne točke

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.

$5
po 1.000 poziva
10
filtriranih korisničkih imena
ISO
format datuma
API
Samo odgovori

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_handles i excluded_x_handles su 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)