Lähe põhisisu juurde
Eesti— Vali keel
Menüü

X Search turunduse jaoks: kasutajanimed, kuupäevad ja filtrid

Õppetund 1 / 12 Värskendatud 30. juuli 2026 Kesktase
Sellel lehel
  1. Muuda X turundusliku jälgimise tööriistaks
  2. Luba X Search Grok API-s
  3. Filtreeri kasutajanimede järgi: sihti kindlaid kontosid
  4. Filtreeri kuupäevade järgi: eralda ajavahemik
  5. Mõista postituste pilte ja videoid
  6. Praktiline harjutus: nädalane jälgimisskript
  7. Peamised punktid

Muuda X turundusliku jälgimise tööriistaks

X (varem Twitter) on endiselt üks väärtuslikumaid platvorme reaalajas kättesaadavate turundusandmete jaoks. Kasutades Grok API tööriista x_search, saad seda infovoogu pärida struktureeritult, filtreeritult ja automatiseeritult otse oma rakendustest või skriptidest.

Erinevalt X-i käsitsi otsingust võimaldab API täpselt sihtida kindlaid kontosid, ajavahemikke ja teemasid. Turundusjuhina tähendab see üleminekut käsitööna tehtavalt jälgimiselt programmeeritavale konkurentsiluure süsteemile.

$5
per 1,000 calls
10
filterable handles
ISO
date format
API
Responses only

Luba X Search Grok API-s

Sa lubad tööriista x_search, deklareerides selle oma API päringu massiivis tools. See toimib eranditult Responses API kaudu (vananenud Chat Completionsi lõpp-punkt on otsingu jaoks iganenud).

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"}]
)

Mudel otsustab automaatselt, millal sinu küsimuse põhjal X-is otsingut teha. Sul ei ole vaja käivitamist käsitsi hallata.

Filtreeri kasutajanimede järgi: sihti kindlaid kontosid

Parameeter allowed_x_handles võimaldab piirata otsingu maksimaalselt 10 konkreetse X-i kontoga. See on ideaalne tööriist otseste konkurentide või partnerite jälgimiseks.

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"
        ]
    }]
)

Vastupidiselt võimaldab excluded_x_handles jätta tulemustest välja kuni 10 kontot. Pane tähele: need kaks parameetrit on vastastikku välistavad (sa ei saa neid samas päringus kombineerida).

Turunduslikud kasutusjuhtumid

  • Konkurentsiseire: jälgi oma 5–10 otsese konkurendi kontot
  • Partnerlused: jälgi oma partnerite ja saadikute postitusi
  • Ökosüsteem: jäta oma kontod tulemustest välja, et näha ainult turgu

Filtreeri kuupäevade järgi: eralda ajavahemik

Parameetrid from_date ja to_date aktsepteerivad kuupäevi ISO 8601 formaadis (AAAA-KK-PP). See võimaldab sihtida kindlat kampaaniat, valdkonna sündmust või võrrelda kahte ajavahemikku.

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"
    }]
)

Kasutajanimede ja kuupäevade see kombinatsioon annab sulle äärmiselt täpse otsinguulatuse, mida võib võrrelda automatiseeritud turu-uuringu tellimusega.

Mõista postituste pilte ja videoid

Kaks boole’i tüüpi parameetrit rikastavad sinu visuaalset jälgimist:

  • enable_image_understanding: mudel analüüsib postitustes olevaid pilte (kampaania visuaalid, infograafikud, ekraanitõmmised)
  • enable_video_understanding: mudel tõlgendab videoid (reklaamklipid, toote teasers, demonstratsioonid)
tools=[{
    "type": "x_search",
    "allowed_x_handles": ["apple"],
    "enable_image_understanding": True,
    "enable_video_understanding": True
}]

Turundajana tähendab see, et Grok suudab kirjeldada sinu konkurentide reklaamvisuaale, tuvastada kasutatud värvikoode või teha kokkuvõtte promotsioonivideo sisust – ja seda kõike programmeeritavalt.

Praktiline harjutus: nädalane jälgimisskript

Siin on täielik skript, mis genereerib nädalase aruande sinu konkurentide kohta:

from datetime import datetime, timedelta

# Arvuta möödunud nädal
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)

Peamised punktid

  • X Search maksab 5 dollarit 1000 päringu kohta, muutes selle väga taskukohaseks jälgimisvahendiks
  • Saad filtreerida kasutajanimede (max 10) või kuupäevade (ISO 8601 formaat) järgi või kombineerida mõlemat
  • allowed_x_handles ja excluded_x_handles on vastastikku välistavad
  • Postituste piltide ja videote analüüs on eksklusiivne X Searchile (ei ole saadaval veebiotsingus)
  • Kasuta Responses API-t (mitte Chat Completionsi, mis on otsingu jaoks iganenud)