X-haku markkinointiin: käyttäjätunnukset, päivämäärät ja suodattimet
Tällä sivulla
Muuta X markkinoinnin seurantatyökaluksi
X (entinen Twitter) on edelleen yksi rikkaimmista alustoista reaaliaikaisen, toimintaan ohjaavan markkinointidatan kannalta. Grok API:n x_search-työkalun avulla voit kysyä tätä tietomassaa jäsennellysti, suodatettuna ja automatisoitavasti suoraan omista sovelluksistasi tai skripteistäsi.
Toisin kuin X:n manuaalinen haku, API:n avulla voit kohdistaa haut tarkasti tietyille tileille, aikajaksoille ja aiheille. Markkinointipäällikölle tämä tarkoittaa siirtymistä käsityömäisestä seurannasta ohjelmoitavaan kilpailija-analyysin keruujärjestelmään.
Ota X-haku käyttöön Grok API:ssa
Otat x_search-työkalun käyttöön määrittelemällä sen API-pyyntösi tools-taulukossa. Se toimii yksinomaan Responses API:n kautta (vanhentunut Chat Completions -päätepiste ei enää tue hakua).
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"}]
)
Malli päättää automaattisesti, milloin se suorittaa haun X:stä kysymyksesi perusteella. Sinun ei tarvitse hallita laukaisua manuaalisesti.
Suodata käyttäjätunnuksilla: kohdista tietyt tilit
allowed_x_handles-parametrin avulla voit rajoittaa haun enintään kymmeneen tiettyyn X-tiliin. Tämä on ihanteellinen työkalu suorien kilpailijoidesi tai kumppanidesi seurantaan.
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"
]
}]
)
Vastaavasti excluded_x_handles-parametri antaa sinun sulkea enintään 10 tiliä tulosten ulkopuolelle. Huomaa: nämä kaksi parametria ovat toisensa poissulkevia (et voi yhdistää niitä samaan pyyntöön).
Markkinoinnin käyttötapaukset
- Kilpailijaseuranta: seuraa 5–10 suoran kilpailijasi tiliä
- Kumppanuudet: seuraa kumppaniesi ja lähettiläidesi julkaisuja
- Ekosysteemi: sulje omat tilisi pois nähdäksesi vain markkinatilanteen
Suodata päivämäärillä: eristä aikajakso
from_date- ja to_date-parametrit hyväksyvät päivämäärät ISO 8601 -muodossa (VVVV-KK-PP). Tämän avulla voit kohdistaa haun tiettyyn kampanjaan, alan tapahtumaan tai verrata kahta eri aikajaksoa.
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"
}]
)
Tämä käyttäjätunnusten ja päivämäärien yhdistelmä antaa sinulle erittäin tarkan hakukohteen, joka vastaa automatisoitua markkinatutkimuksen toimeksiantoa.
Ymmärrä julkaisujen kuvat ja videot
Kaksi boolean-parametria rikastuttavat visuaalista seurantaasi:
enable_image_understanding: malli analysoi julkaisuissa olevat kuvat (kampanjavisiuaalit, infografiikat, kuvakaappaukset)enable_video_understanding: malli tulkitsee videot (mainosspotit, tuoteteaserit, demonstraatiot)
tools=[{
"type": "x_search",
"allowed_x_handles": ["apple"],
"enable_image_understanding": True,
"enable_video_understanding": True
}]
Markkinoijalle tämä tarkoittaa, että Grok voi kuvailla kilpailijoidesi mainosvisuaaleja, tunnistaa käytetyt värikoodit tai tiivistää promootiovideon sisällön – kaikki ohjelmoitavasti.
Käytännön harjoitus: viikkoseurannan skripti
Tässä on valmis skripti, joka tuottaa viikkoraportin kilpailijoistasi:
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)
Keskeiset asiat
- X-haku maksaa 5 dollaria per 1 000 hakua, mikä tekee siitä erittäin edullisen seurantatyökalun
- Voit suodata käyttäjätunnuksilla (max 10) tai päivämäärillä (ISO 8601 -muoto) tai yhdistää molemmat
allowed_x_handlesjaexcluded_x_handlesovat toisensa poissulkevia- Julkaisujen kuvien ja videoiden analyysi on saatavilla vain X-haussa (ei käytettävissä Web Searchissa)
- Käytä Responses API:a (ei Chat Completionsia, joka on vanhentunut hakua varten)