X Search għall-Marketing: Handles, Dati u Filtri
F'din il-paġna
Ibdel X f’Għodda ta’ Monitoraġġ tal-Marketing
X (qabel Twitter) tibqa’ waħda mill-aktar pjattaformi rikki f’data tal-marketing azzjonabbli f’ħin reali. Bl-għodda x_search fl-API ta’ Grok, tista’ tikkonsulta din il-massa ta’ informazzjoni b’mod strutturat, iffiltrat u awtomatizzabbli, direttament mill-applikazzjonijiet jew l-iskrits tiegħek.
Meta mqabbla mat-tiftixa manwali fuq X, l-API tippermettilek timmira kontijiet, perjodi u suġġetti speċifiċi b’mod preċiż. Għal maniġer tal-marketing, dan ifisser li tgħaddi minn monitoraġġ artisanali għal sistema programmabbli ta’ ġbir ta’ intelligence kompetittiva.
Attiva X Search fl-API ta’ Grok
Tattiva l-għodda x_search billi tiddikjaraha fl-array tools tat-talba tal-API tiegħek. Taħdem esklużivament fuq l-API tar-Risposti (l-endpoint antik ta’ Chat Completions huwa deprekat għat-tiftix).
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"}]
)
Il-mudell jiddeċiedi awtomatikament meta jniedi tfittxija fuq X ibbażata fuq il-mistoqsija tiegħek. M’għandekx bżonn timmaniġġja t-triggering manwalment.
Iffiltra skont il-Handles: Immira Kontijiet Speċifiċi
Il-parametru allowed_x_handles jippermettilek tirrestrinġi t-tiftixa għal massimu ta’ 10 kontijiet X speċifiċi. Din hija l-għodda ideali biex timmonitorja l-kompetituri diretti jew is-sħab tiegħek.
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"
]
}]
)
B’mod kuntrarju, excluded_x_handles jippermettilek teskludi sa 10 kont mir-riżultati. Nota: dawn iż-żewġ parametri huma esklussivi reċiprokament (ma tistax tgħaqqadhom fl-istess talba).
Każijiet ta’ Użu tal-Marketing
- Monitoraġġ kompetittiv: traċċa l-5 sa 10 kont tal-kompetituri diretti tiegħek
- Sħubijiet: segwi l-posts mis-sħab u l-ambaxxaturi tiegħek
- Ekosistema: eskludi l-kontijiet tiegħek stess biex tara biss is-suq
Iffiltra skont id-Dati: Iżola Perjodu
Il-parametri from_date u to_date jaċċettaw dati fil-format ISO 8601 (YYYY-MM-DD). Dan jippermettilek timmira kampanja speċifika, avveniment tas-settur, jew tqabbel żewġ perjodi.
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"
}]
)
Din il-kombinazzjoni ta’ handles + dati tagħtik ambitu ta’ tfittxija estremament preċiż, komparabbli ma’ brief awtomatizzat ta’ riċerka tas-suq.
Fehem l-Immaġni u l-Vidjows tal-Posts
Żewġ parametri Booleani jarricchixxu l-monitoraġġ viżiv tiegħek:
enable_image_understanding: il-mudell janalizza l-immaġni li jinsabu fil-posts (viżwali tal-kampanja, infografiċi, screenshots)enable_video_understanding: il-mudell jinterpreta l-vidjows (spot tar-reklamar, teasers tal-prodott, dimostrazzjonijiet)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Għal marketer, dan ifisser li Grok jista’ jiddeskrivi l-viżwali tar-reklamar tal-kompetituri tiegħek, jidentifika l-kodiċijiet tal-kulur użati, jew jagħmel sommarju tal-kontenut ta’ vidjo promozzjonali, kollha b’mod programmatiku.
Prattika: Skritt ta’ Monitoraġġ Settimanali
Hawnhekk hemm skritt sħiħ li jiġġenera rapport ta’ monitoraġġ settimanali fuq il-kompetituri tiegħek:
from datetime import datetime, timedelta
# Ikkalkula l-ġimgħa li għaddiet
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)
Punti Ewlenin
- X Search jiswief $5 kull 1,000 sejħa, u jagħmilha għodda ta’ monitoraġġ affordabbli ħafna
- Tista’ tiffiltra skont handles (massimu 10) jew dati (format ISO 8601), jew tgħaqqad iż-żewġ affarijiet
allowed_x_handlesuexcluded_x_handleshuma esklussivi reċiprokament- L-analiżi tal-immaġni u l-vidjows fil-posts hija esklużiva għal X Search (mhux disponibbli fuq Web Search)
- Uża l-API tar-Risposti (mhux Chat Completions, li huwa deprekat għat-tiftix)