X paieška rinkodarai: paskyros, datos ir filtrai
Šiame puslapyje
Paversk X rinkodaros stebėsenos įrankiu
X (buvęs „Twitter“) išlieka viena turtingiausių platformų veiksmingiems rinkodaros duomenims gauti realiuoju laiku. Naudodamas x_search įrankį Grok API, gali struktūruotai, filtruotai ir automatiškai užklausti šią informacijos gausą tiesiai iš savo programų ar scenarijų.
Skirtingai nei rankinė paieška X, API leidžia tiksliai taikyti konkrečias paskyras, laikotarpius ir temas. Rinkodaros vadovui tai reiškia perėjimą nuo amatininkiškos stebėsenos prie programuojamos konkurencinės žvalgybos duomenų rinkimo sistemos.
Įgalink X paiešką Grok API
Įrankį x_search įgalini jį deklaruodamas savo API užklausos masyve tools. Jis veikia tik su „Responses API“ (senasis „Chat Completions“ galinis punktas paieškai yra pasenęs).
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"}]
)
Modelis automatiškai nusprendžia, kada inicijuoti paiešką X pagal tavo klausimą. Tau nereikia rankiniu būdu valdyti suaktyvinimo.
Filtruok pagal paskyras: taikykitės į konkrečias paskyras
Parametras allowed_x_handles leidžia apriboti paiešką daugiausia iki 10 konkrečių X paskyrų. Tai idealus įrankis stebėti tiesioginius konkurentus ar partnerius.
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"
]
}]
)
Atvirkščiai, excluded_x_handles leidžia pašalinti iki 10 paskyrų iš rezultatų. Pastaba: šie du parametrai yra nesuderinami (negalima jų derinti toje pačioje užklausoje).
Rinkodaros naudojimo atvejai
- Konkurentų stebėsena: sek 5–10 tiesioginių konkurentų paskyrų
- Partnerystės: stebėk savo partnerių ir ambasadorių įrašus
- Ekosistema: neįtrauk savo paskyrų, kad matytum tik rinką
Filtruok pagal datas: izoliuok laikotarpį
Parametrai from_date ir to_date priima datas ISO 8601 formatu (MMMM-MM-DD). Tai leidžia taikyti konkrečią kampaniją, sektoriaus įvykį arba palyginti du laikotarpius.
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"
}]
)
Šis paskyrų ir datų derinys suteikia itin tikslų paieškos aprėptį, prilygstančią automatizuotai rinkos tyrimų užduočiai.
Suprask įrašų vaizdus ir vaizdo įrašus
Du loginiai parametrai praturtina tavo vaizdinę stebėseną:
enable_image_understanding: modelis analizuoja įrausuose esančius vaizdus (kampanijų vizualus, infografikas, ekrano kopijas)enable_video_understanding: modelis interpretuoja vaizdo įrašus (reklamos klipus, produktų anonansus, demonstracijas)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Rinkodaros specialistui tai reiškia, kad Grok gali programuotai aprašyti konkurentų reklamos vizualus, nustatyti naudotas spalvų kodų schemas arba apibendrinti reklaminio vaizdo įrašo turinį.
Praktika: savaitinės stebėsenos scenarijus
Štai pilnas scenarijus, generuojantis savaitinę konkurentų stebėsenos ataskaitą:
from datetime import datetime, timedelta
# Apskaičiuok praėjusią savaitę
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)
Svarbiausi punktai
- X paieška kainuoja 5 USD už 1 000 užklausų, todėl tai labai prieinama stebėsenos priemonė
- Gali filtruoti pagal paskyras (daugiausia 10) arba datas (ISO 8601 formatas), arba derinti abu būdus
allowed_x_handlesirexcluded_x_handlesyra nesuderinami- Vaizdų ir vaizdo įrašų analizė įrašuose galima tik per X paiešką (neprieinama per „Web Search“)
- Naudok „Responses API“ (ne „Chat Completions“, kuris paieškai yra pasenęs)