Căutare X pentru Marketing: Handle-uri, Date și Filtre
Pe această pagină
- Transformați X într-un Instrument de Monitorizare pentru Marketing
- Activarea Căutării X în API-ul Grok
- Filtrare după Handle-uri: Țintirea Conturilor Specifice
- Filtrare după Date: Izolarea unei Perioade
- Înțelegerea Imaginilor și Videoclipurilor din Postări
- Exercițiu Practic: Script de Monitorizare Săptămânală
- Puncte cheie
Transformați X într-un Instrument de Monitorizare pentru Marketing
X (fostul Twitter) rămâne una dintre cele mai bogate platforme pentru date de marketing acționabile în timp real. Cu instrumentul x_search din API-ul Grok, puteți interoga această masă de informații într-un mod structurat, filtrat și automatizabil, direct din aplicațiile sau scripturile dumneavoastră.
Spre deosebire de căutarea manuală pe X, API-ul vă permite să țintiți conturi specifice, perioade și subiecte cu precizie. Pentru un manager de marketing, aceasta înseamnă trecerea de la o monitorizare artizanală la un sistem programabil de colectare a informațiilor competitive.
Activarea Căutării X în API-ul Grok
Activați instrumentul x_search declarându-l în tabloul tools al cererii dumneavoastră către API. Acesta funcționează exclusiv pe API-ul Responses (punctul final legacy Chat Completions este depreciat pentru căutare).
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"}]
)
Modelul decide automat când să lanseze o căutare pe X pe baza întrebării dumneavoastră. Nu este nevoie să gestionați declanșarea manual.
Filtrare după Handle-uri: Țintirea Conturilor Specifice
Parametrul allowed_x_handles vă permite să restricționați căutarea la un maximum de 10 conturi X specifice. Acesta este instrumentul ideal pentru monitorizarea competitorilor direcți sau a partenerilor dumneavoastră.
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"
]
}]
)
Invers, excluded_x_handles vă permite să excludeți până la 10 conturi din rezultate. Notă: acești doi parametri sunt exclusivi reciproc (nu îi puteți combina în aceeași cerere).
Cazuri de Utilizare în Marketing
- Monitorizare competitivă: urmăriți cele 5–10 conturi ale competitorilor dumneavoastră direcți
- Parteneriate: urmăriți postările partenerilor și ambasadorilor dumneavoastră
- Ecosistem: excludeți propriile conturi pentru a vedea doar piața
Filtrare după Date: Izolarea unei Perioade
Parametrii from_date și to_date acceptă date în format ISO 8601 (AAAA-LL-ZZ). Acest lucru vă permite să țintiți o campanie specifică, un eveniment de sector sau să comparați două perioade.
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"
}]
)
Această combinație de handle-uri + date vă oferă un domeniu de căutare extrem de precis, comparabil cu un brief automatizat de cercetare de piață.
Înțelegerea Imaginilor și Videoclipurilor din Postări
Doi parametri booleeni vă îmbogățesc monitorizarea vizuală:
enable_image_understanding: modelul analizează imaginile conținute în postări (vizuale de campanie, infografice, capturi de ecran)enable_video_understanding: modelul interpretează videoclipurile (spoturi publicitare, teaser-e de produs, demonstrații)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Pentru un marketer, aceasta înseamnă că Grok poate descrie vizualele publicitare ale competitorilor dumneavoastră, poate identifica codurile de culori utilizate sau poate rezuma conținutul unui video promoțional, totul în mod programatic.
Exercițiu Practic: Script de Monitorizare Săptămânală
Iată un script complet care generează un raport de monitorizare săptămânală asupra competitorilor dumneavoastră:
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)
Puncte cheie
- Căutarea X costă $5 per 1,000 calls, ceea ce o face un instrument de monitorizare foarte accesibil
- Puteți filtra după handle-uri (maxim 10) sau date (format ISO 8601), sau le puteți combina pe ambele
allowed_x_handlesșiexcluded_x_handlessunt exclusivi reciproc- Analiza imaginilor și videoclipurilor din postări este exclusivă Căutării X (nu este disponibilă pe Căutarea Web)
- Utilizați API-ul Responses (nu Chat Completions, care este depreciat pentru căutare)