Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

X-haku markkinointiin: käyttäjätunnukset, päivämäärät ja suodattimet

Oppitunti 1 / 12 Päivitetty 30. heinäkuuta 2026 Keskitasoinen
Tällä sivulla
  1. Muuta X markkinoinnin seurantatyökaluksi
  2. Ota X-haku käyttöön Grok API:ssa
  3. Suodata käyttäjätunnuksilla: kohdista tietyt tilit
  4. Suodata päivämäärillä: eristä aikajakso
  5. Ymmärrä julkaisujen kuvat ja videot
  6. Käytännön harjoitus: viikkoseurannan skripti
  7. Keskeiset asiat

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.

$5
per 1,000 calls
10
filterable handles
ISO
date format
API
Responses only

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_handles ja excluded_x_handles ovat 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)