Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

X Search għall-Marketing: Handles, Dati u Filtri

Lezzjoni 1 / 12 Aġġornat 30 ta’ Lulju 2026 Livell Medju
F'din il-paġna
  1. Ibdel X f’Għodda ta’ Monitoraġġ tal-Marketing
  2. Attiva X Search fl-API ta’ Grok
  3. Iffiltra skont il-Handles: Immira Kontijiet Speċifiċi
  4. Iffiltra skont id-Dati: Iżola Perjodu
  5. Fehem l-Immaġni u l-Vidjows tal-Posts
  6. Prattika: Skritt ta’ Monitoraġġ Settimanali
  7. Punti Ewlenin

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.

$5
kull 1,000 sejħa
10
handles li jistgħu jiġu ffiltrati
ISO
format tad-data
API
Risposti biss

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_handles u excluded_x_handles huma 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)