X Search turunduse jaoks: kasutajanimed, kuupäevad ja filtrid
Sellel lehel
Muuda X turundusliku jälgimise tööriistaks
X (varem Twitter) on endiselt üks väärtuslikumaid platvorme reaalajas kättesaadavate turundusandmete jaoks. Kasutades Grok API tööriista x_search, saad seda infovoogu pärida struktureeritult, filtreeritult ja automatiseeritult otse oma rakendustest või skriptidest.
Erinevalt X-i käsitsi otsingust võimaldab API täpselt sihtida kindlaid kontosid, ajavahemikke ja teemasid. Turundusjuhina tähendab see üleminekut käsitööna tehtavalt jälgimiselt programmeeritavale konkurentsiluure süsteemile.
Luba X Search Grok API-s
Sa lubad tööriista x_search, deklareerides selle oma API päringu massiivis tools. See toimib eranditult Responses API kaudu (vananenud Chat Completionsi lõpp-punkt on otsingu jaoks iganenud).
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"}]
)
Mudel otsustab automaatselt, millal sinu küsimuse põhjal X-is otsingut teha. Sul ei ole vaja käivitamist käsitsi hallata.
Filtreeri kasutajanimede järgi: sihti kindlaid kontosid
Parameeter allowed_x_handles võimaldab piirata otsingu maksimaalselt 10 konkreetse X-i kontoga. See on ideaalne tööriist otseste konkurentide või partnerite jälgimiseks.
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"
]
}]
)
Vastupidiselt võimaldab excluded_x_handles jätta tulemustest välja kuni 10 kontot. Pane tähele: need kaks parameetrit on vastastikku välistavad (sa ei saa neid samas päringus kombineerida).
Turunduslikud kasutusjuhtumid
- Konkurentsiseire: jälgi oma 5–10 otsese konkurendi kontot
- Partnerlused: jälgi oma partnerite ja saadikute postitusi
- Ökosüsteem: jäta oma kontod tulemustest välja, et näha ainult turgu
Filtreeri kuupäevade järgi: eralda ajavahemik
Parameetrid from_date ja to_date aktsepteerivad kuupäevi ISO 8601 formaadis (AAAA-KK-PP). See võimaldab sihtida kindlat kampaaniat, valdkonna sündmust või võrrelda kahte ajavahemikku.
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"
}]
)
Kasutajanimede ja kuupäevade see kombinatsioon annab sulle äärmiselt täpse otsinguulatuse, mida võib võrrelda automatiseeritud turu-uuringu tellimusega.
Mõista postituste pilte ja videoid
Kaks boole’i tüüpi parameetrit rikastavad sinu visuaalset jälgimist:
enable_image_understanding: mudel analüüsib postitustes olevaid pilte (kampaania visuaalid, infograafikud, ekraanitõmmised)enable_video_understanding: mudel tõlgendab videoid (reklaamklipid, toote teasers, demonstratsioonid)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Turundajana tähendab see, et Grok suudab kirjeldada sinu konkurentide reklaamvisuaale, tuvastada kasutatud värvikoode või teha kokkuvõtte promotsioonivideo sisust – ja seda kõike programmeeritavalt.
Praktiline harjutus: nädalane jälgimisskript
Siin on täielik skript, mis genereerib nädalase aruande sinu konkurentide kohta:
from datetime import datetime, timedelta
# Arvuta möödunud nädal
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)
Peamised punktid
- X Search maksab 5 dollarit 1000 päringu kohta, muutes selle väga taskukohaseks jälgimisvahendiks
- Saad filtreerida kasutajanimede (max 10) või kuupäevade (ISO 8601 formaat) järgi või kombineerida mõlemat
allowed_x_handlesjaexcluded_x_handleson vastastikku välistavad- Postituste piltide ja videote analüüs on eksklusiivne X Searchile (ei ole saadaval veebiotsingus)
- Kasuta Responses API-t (mitte Chat Completionsi, mis on otsingu jaoks iganenud)