Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Vyhledávání na X pro marketing: účty, data a filtry

Lekce 1 z 12 Aktualizováno 30. července 2026 Mírně pokročilý
Na této stránce
  1. Proměň X v nástroj pro marketingový monitoring
  2. Aktivace vyhledávání na X v API Grok
  3. Filtrace podle účtů: Cílení na konkrétní profily
  4. Filtrace podle dat: Izolace období
  5. Porozumění obrázkům a videím v příspěvcích
  6. Praxe: Skript pro týdenní monitoring
  7. Klíčové poznatky

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í.

$5
za 1 000 volání
10
filtrovatelných účtů
ISO
formát data
API
Pouze odpovědi

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_handles a excluded_x_handles jsou 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é)