X Search a marketing számára: Felhasználónevek, dátumok és szűrők
Ezen az oldalon
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.
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 azexcluded_x_handlesparamé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)