Vyhledávání na X pro marketing: účty, data a filtry
Na této stránce
Proměň X v nástroj pro marketingový monitoring
X (dříve Twitter) zůstává jednou z nejbohatších platforem pro získávání akčních marketingových dat v reálném čase. Díky nástroji x_search v API Grok můžeš tuto masu informací dotazovat strukturovaným, filtrovaným a automatizovatelným způsobem přímo ze svých aplikací nebo skriptů.
Na rozdíl od ručního vyhledávání na X ti API umožňuje přesně cílit na konkrétní účty, období a témata. Pro marketingového manažera to znamená posun od řemeslného sledování k programovatelnému systému sběru konkurenčních informací.
Aktivace vyhledávání na X v API Grok
Nástroj x_search aktivuješ jeho deklarací v poli tools ve svém požadavku na API. Funguje výhradně s API Responses (starší koncový bod Chat Completions je pro vyhledávání zastaralý).
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, kdy spustit vyhledávání na X na základě tvého dotazu. Nemusíš spouštění spravovat ručně.
Filtrace podle účtů: Cílení na konkrétní profily
Parametr allowed_x_handles ti umožňuje omezit vyhledávání na maximálně 10 konkrétních účtů na X. Je to ideální nástroj pro sledování přímých konkurentů nebo partnerů.
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 parametr excluded_x_handles ti umožňuje vyloučit až 10 účtů z výsledků. Poznámka: tyto dva parametry jsou vzájemně se vylučující (nelze je kombinovat v jednom požadavku).
Využití v marketingu
- Sledování konkurence: sleduj 5–10 účtů svých přímých konkurentů
- Partnerství: sleduj příspěvky svých partnerů a ambasadorů
- Ekosystém: vyluč své vlastní účty, abys viděl pouze trh
Filtrace podle dat: Izolace období
Parametry from_date a to_date přijímají data ve formátu ISO 8601 (RRRR-MM-DD). Umožňují ti cílit na konkrétní kampaň, událost v odvětví nebo porovnat dvě období.
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"
}]
)
Tato kombinace účtů a dat ti poskytuje extrémně přesný rozsah vyhledávání, srovnatelný s automatizovaným zadáním pro průzkum trhu.
Porozumění obrázkům a videím v příspěvcích
Dva boolean parametry obohacují tvé vizuální sledování:
enable_image_understanding: model analyzuje obrázky obsažené v příspěvcích (vizuály kampaní, infografiky, screenshoty)enable_video_understanding: model interpretuje videa (reklamní spoty, upoutávky na produkty, demonstrace)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Pro marketéra to znamená, že Grok může programovatelně popsat reklamní vizuály tvých konkurentů, identifikovat použité barevné kódy nebo shrnout obsah propagačního videa.
Praxe: Skript pro týdenní monitoring
Zde je kompletní skript, který generuje týdenní monitorovací zprávu o tvých konkurentech:
from datetime import datetime, timedelta
# Výpočet posledního týdne
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)
Klíčové poznatky
- Vyhledávání na X stojí 5 $ za 1 000 volání, což z něj činí velmi dostupný nástroj pro monitoring
- Můžeš filtrovat podle účtů (max. 10) nebo dat (formát ISO 8601), případně obojí kombinovat
- Parametry
allowed_x_handlesaexcluded_x_handlesjsou vzájemně se vylučující - Analýza obrázků a videí v příspěvcích je exkluzivní pro vyhledávání na X (není dostupná pro webové vyhledávání)
- Používej API Responses (nikoli Chat Completions, které je pro vyhledávání zastaralé)