Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

X-sökning för marknadsföring: Användarnamn, datum och filter

Lektion 1 av 12 Uppdaterad 30 juli 2026 Medelnivå
På denna sida
  1. Gör X till ett verktyg för marknadsövervakning
  2. Aktivera X-sökning i Grok API
  3. Filtrera efter användarnamn: Måla in specifika konton
  4. Filtrera efter datum: Isolera en tidsperiod
  5. Förstå bilder och videor i inlägg
  6. Praktiskt exempel: Skript för veckovis övervakning
  7. Viktiga punkter

Gör X till ett verktyg för marknadsövervakning

X (tidigare Twitter) är fortfarande en av de rikaste plattformarna för handlingsbar marknadsföringsdata i realtid. Med verktyget x_search i Grok API kan du fråga denna informationsmassa på ett strukturerat, filtrerat och automatiserbart sätt, direkt från dina applikationer eller skript.

Till skillnad från manuell sökning på X låter API:t dig måla in specifika konton, tidsperioder och ämnen med precision. För en marknadsansvarig innebär detta att du går från hantverksmässig övervakning till ett programmerbart system för insamling av konkurrensintelligens.

$5
per 1 000 anrop
10
filtrerbara användarnamn
ISO
datumformat
API
Endast svar

Aktivera X-sökning i Grok API

Du aktiverar verktyget x_search genom att deklarera det i tools-arrayen i din API-förfrågan. Det fungerar uteslutande med Responses API (den äldre ändpunkten Chat Completions är avskriven för sökning).

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"}]
)

Modellen beslutar automatiskt när den ska starta en sökning på X baserat på din fråga. Du behöver inte hantera utlösningen manuellt.

Filtrera efter användarnamn: Måla in specifika konton

Parametern allowed_x_handles låter dig begränsa sökningen till maximalt 10 specifika X-konton. Detta är det ideala verktyget för att övervaka dina direkta konkurrenter eller partners.

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"
        ]
    }]
)

Omvänt låter excluded_x_handles dig exkludera upp till 10 konton från resultaten. Observera: dessa två parametrar är ömsesidigt uteslutande (du kan inte kombinera dem i samma förfrågan).

Användningsområden inom marknadsföring

  • Konkurrensbevakning: spåra de 5–10 konton som tillhör dina direkta konkurrenter
  • Partnerskap: följ inlägg från dina partners och ambassadörer
  • Ekosystem: exkludera dina egna konton för att bara se marknaden

Filtrera efter datum: Isolera en tidsperiod

Parametrarna from_date och to_date accepterar datum i ISO 8601-format (ÅÅÅÅ-MM-DD). Detta låter dig måla in en specifik kampanj, en branschevent eller jämföra två perioder.

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"
    }]
)

Denna kombination av användarnamn och datum ger dig ett extremt precist sökomfång, jämförbart med en automatiserad marknadsundersökningsbrief.

Förstå bilder och videor i inlägg

Två booleska parametrar berikar din visuella övervakning:

  • enable_image_understanding: modellen analyserar bilder som finns i inlägg (kampanjvisualiseringar, infografik, skärmdumpar)
  • enable_video_understanding: modellen tolkar videor (reklamfilmer, produktteasers, demonstrationer)
tools=[{
    "type": "x_search",
    "allowed_x_handles": ["apple"],
    "enable_image_understanding": True,
    "enable_video_understanding": True
}]

För en marknadsförare innebär detta att Grok kan beskriva dina konkurrenters reklamvisualiseringar, identifiera använda färgkoder eller sammanfatta innehållet i en reklamvideo, allt programmerat.

Praktiskt exempel: Skript för veckovis övervakning

Här är ett komplett skript som genererar en veckovis övervakningsrapport om dina konkurrenter:

from datetime import datetime, timedelta

# Beräkna den senaste veckan
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)

Viktiga punkter

  • X-sökning kostar 5 USD per 1 000 anrop, vilket gör det till ett mycket prisvärt övervakningsverktyg
  • Du kan filtrera efter användarnamn (max 10) eller datum (ISO 8601-format), eller kombinera båda
  • allowed_x_handles och excluded_x_handles är ömsesidigt uteslutande
  • Bild- och videoanalys i inlägg är exklusivt för X-sökning (inte tillgängligt i webbsökning)
  • Använd Responses API (inte Chat Completions, som är avskriven för sökning)