Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

X Search a marketing számára: Felhasználónevek, dátumok és szűrők

1. lecke 12 közül Frissítve 2026. július 30. Középhaladó
Ezen az oldalon
  1. Alakítsd az X-et marketingfigyelő eszközzé
  2. Az X Search engedélyezése a Grok API-ban
  3. Szűrés felhasználónevek alapján: Célzott fiókok
  4. Szűrés dátumok alapján: Időszak izolálása
  5. Bejegyzések képeinek és videóinak értelmezése
  6. Gyakorlat: Heti monitorozó szkript
  7. Főbb megállapítások

Alakítsd az X-et marketingfigyelő eszközzé

Az X (korábban Twitter) továbbra is az egyik leggazdagabb platform a valós idejű, cselekvésre ösztönző marketingadatok szempontjából. A Grok API x_search eszközével ezt az információtömeget strukturáltan, szűrve és automatizálható módon kérdezheted le közvetlenül az alkalmazásaidból vagy szkriptjeidből.

Az X manuális keresésével ellentétben az API lehetővé teszi, hogy pontosan célzott fiókokat, időszakokat és témákat válassz ki. Marketingvezetőként ez azt jelenti, hogy a kézműves jellegű monitorozásból egy programozható versenyhelyzet-elemző gyűjtőrendszerbe lépsz át.

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

Az X Search engedélyezése a Grok API-ban

Az x_search eszközt úgy aktiválod, hogy deklarálod azt az API-kérésed tools tömbjében. Kizárólag a Responses API-n működik (a régi Chat Completions végpont keresés esetén elavult).

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

A modell automatikusan eldönti, mikor indítson keresést az X-en a kérdésed alapján. Nem kell manuálisan kezelned az indítást.

Szűrés felhasználónevek alapján: Célzott fiókok

Az allowed_x_handles paraméterrel legfeljebb 10 konkrét X-fiókra korlátozhatod a keresést. Ez az ideális eszköz közvetlen versenytársaid vagy partnereid monitorozására.

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

Ezzel szemben az excluded_x_handles paraméterrel legfeljebb 10 fiókot zárhatsz ki az eredményekből. Megjegyzés: ez a két paraméter kölcsönösen kizárja egymást (nem kombinálhatod őket ugyanabban a kérésben).

Marketing alkalmazási esetek

  • Versenytárs-elemzés: kövesd nyomon 5–10 közvetlen versenytársad fiókját
  • Partnerségek: figyeld partnereid és nagyköveteid bejegyzéseit
  • Ökoszisztéma: zárd ki saját fiókjaidat, hogy csak a piacot lásd

Szűrés dátumok alapján: Időszak izolálása

A from_date és to_date paraméterek ISO 8601 formátumú dátumokat (ÉÉÉÉ-HH-NN) fogadnak el. Így célzottan vizsgálhatsz egy adott kampányt, egy szektort érintő eseményt, vagy összehasonlíthatsz két időszakot.

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

A felhasználónevek és dátumok ezen kombinációja rendkívül pontos keresési hatókört biztosít, amely összehasonlítható egy automatizált piackutatási megbízással.

Bejegyzések képeinek és videóinak értelmezése

Két logikai (boolean) paraméter gazdagítja vizuális monitorozásodat:

  • enable_image_understanding: a modell elemzi a bejegyzésekben található képeket (kampányvizuálok, infografikák, képernyőmentések)
  • enable_video_understanding: a modell értelmezi a videókat (reklámfilmek, termék-előzetesek, bemutatók)
tools=[{
    "type": "x_search",
    "allowed_x_handles": ["apple"],
    "enable_image_understanding": True,
    "enable_video_understanding": True
}]

Marketerként ez azt jelenti, hogy a Grok programozottan le tudja írni versenytársaid hirdetési vizuáljait, azonosítani tudja a használt színkódokat, vagy összefoglalni tudja egy promóciós videó tartalmát.

Gyakorlat: Heti monitorozó szkript

Íme egy teljes szkript, amely heti jelentést generál versenytársaidról:

from datetime import datetime, timedelta

# Calculate the past week
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)

Főbb megállapítások

  • Az X Search költsége $5 per 1,000 calls, így nagyon megfizethető monitorozó eszköz
  • Szűrhetsz felhasználónevek (max. 10) vagy dátumok (ISO 8601 formátum) alapján, illetve kombinálhatod is őket
  • Az allowed_x_handles és az excluded_x_handles paraméterek kölcsönösen kizárják egymást
  • A bejegyzések képeinek és videóinak elemzése kizárólag az X Search sajátja (a Web Search nem rendelkezik ezzel)
  • Használd a Responses API-t (ne a Chat Completions-t, amely keresés esetén elavult)