Vyhľadávanie na X pre marketing: mená používateľov, dátumy a filtre
Na tejto strane
- Premení X na nástroj na monitorovanie marketingu
- Aktivácia vyhľadávania na X v API Grok
- Filtrovanie podľa mien používateľov: Cielenie na konkrétne účty
- Filtrovanie podľa dátumov: Izolovanie obdobia
- Pochopenie obrázkov a videí v príspevkoch
- Praktické cvičenie: Skript na týždenné monitorovanie
- Kľúčové poznatky
Premení X na nástroj na monitorovanie marketingu
X (predtým Twitter) zostáva jednou z najbohatších platforiem na získavanie použiteľných marketingových údajov v reálnom čase. Pomocou nástroja x_search v API Grok môžeš túto masu informácií dopytovať štruktúrovaným, filtrovaným a automatizovateľným spôsobom priamo zo svojich aplikácií alebo skriptov.
Na rozdiel od manuálneho vyhľadávania na X ti API umožňuje presne cieliť na konkrétne účty, obdobia a témy. Pre marketingového manažéra to znamená prechod od remeselného monitorovania k programovateľnému systému zberu konkurenčných informácií.
Aktivácia vyhľadávania na X v API Grok
Nástroj x_search aktivuješ jeho deklarovaním v poli tools vo svojej požiadavke API. Funguje výlučne na API Responses (starší koncový bod Chat Completions je pre vyhľadávanie zastaraný).
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 automaticky rozhodne, kedy spustiť vyhľadávanie na X na základe tvojej otázky. Nemusíš spúšťanie riadiť manuálne.
Filtrovanie podľa mien používateľov: Cielenie na konkrétne účty
Parameter allowed_x_handles ti umožňuje obmedziť vyhľadávanie na maximálne 10 konkrétnych účtov X. Je to ideálny nástroj na monitorovanie tvojich priamych konkurentov alebo partnerov.
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"
]
}]
)
Naopak, parameter excluded_x_handles ti umožňuje vylúčiť až 10 účtov z výsledkov. Poznámka: tieto dva parametre sú vzájomne sa vylučujúce (nemôžeš ich kombinovať v tej istej požiadavke).
Prípady použitia v marketingu
- Monitorovanie konkurencie: sleduj 5–10 účtov svojich priamych konkurentov
- Partnerstvá: sleduj príspevky od svojich partnerov a ambasádorov
- Ekosystém: vylúč svoje vlastné účty, aby si videl iba trh
Filtrovanie podľa dátumov: Izolovanie obdobia
Parametre from_date a to_date akceptujú dátumy vo formáte ISO 8601 (RRRR-MM-DD). Umožňuje ti to cieliť na konkrétnu kampaň, udalosť v odvetví alebo porovnať dve obdobia.
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"
}]
)
Táto kombinácia mien používateľov a dátumov ti poskytuje extrémne presný rozsah vyhľadávania, porovnateľný s automatizovaným briefom pre prieskum trhu.
Pochopenie obrázkov a videí v príspevkoch
Dva booleovské parametre obohacujú tvoje vizuálne monitorovanie:
enable_image_understanding: model analyzuje obrázky obsiahnuté v príspevkoch (vizuály kampaní, infografiky, snímky obrazovky)enable_video_understanding: model interpretuje videá (reklamné spoty, upútavky na produkty, demonštrácie)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Pre marketéra to znamená, že Grok dokáže programovo opísať reklamné vizuály tvojej konkurencie, identifikovať použité farebné kódy alebo zhrnúť obsah propagačného videa.
Praktické cvičenie: Skript na týždenné monitorovanie
Tu je kompletný skript, ktorý generuje týždennú monitorovaciu správu o tvojich konkurentoch:
from datetime import datetime, timedelta
# Vypočítaj posledný týždeň
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)
Kľúčové poznatky
- Vyhľadávanie na X stojí 5 USD za 1 000 volaní, čo z neho robí veľmi cenovo dostupný nástroj na monitorovanie
- Môžeš filtrovať podľa mien používateľov (max. 10) alebo dátumov (formát ISO 8601), prípadne obe kombinovať
- Parametre
allowed_x_handlesaexcluded_x_handlessú vzájomne sa vylučujúce - Analýza obrázkov a videí v príspevkoch je exkluzívna pre vyhľadávanie na X (nie je dostupná pri vyhľadávaní na webe)
- Používaj API Responses (nie Chat Completions, ktoré je pre vyhľadávanie zastarané)