Aktivér X-søgning til Twitter-forskning
På denne side
Få adgang til X’s realtidsfeed fra din API
X (tidligere Twitter) er stadig den foretrukne platform for realtidsinformation: virksomhedsmeddelelser, reaktioner på nyheder, nye tendenser og offentlige debatter. Grok API’s x_search-værktøj lader dig spørge direkte ind i dette feed fra dine applikationer uden behov for et separat X API-abonnement eller administration af yderligere abonnementer.

Hvor den ældre Chat Completions-endpoint tilbød en sources: ["x"]-parameter i search_parameters, leverer Responses API et dedikeret værktøj med langt finere filtreringsmuligheder.
Aktivér X-søgning
Aktiveringen følger samme princip som web_search. Du tilføjer x_search-værktøjet til tools-arrayet:
response = client.responses.create(
model="grok-4.5",
input="What are people saying about the AI Act on X today?",
tools=[{"type": "x_search"}]
)
print(response.output_text)
Modellen beslutter automatisk, hvornår den skal spørge X baseret på arten af din prompt. Spørgsmål om aktuelle begivenheder, offentlig mening eller tendenser vil naturligt udløse en søgning.
De fire funktioner i X-søgning
x_search-værktøjet går ud over simpel søgning efter nøgleord. Det tilbyder fire spørgemåder:
- Nøgleordssøgning: Find indlæg, der indeholder specifikke termer
- Semantisk søgning: Find indlæg relateret til et koncept, selv uden de præcise ord
- Brugersøgning: Identificér relevante konti om et emne
- Tråd-hentning: Rekonstruér komplette diskussionstråde
Modellen vælger automatisk den mest hensigtsmæssige måde baseret på din anmodning. Du behøver ikke eksplicit angive, hvilken måde du vil bruge.
Brug med forskellige SDK’er
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
OpenAI SDK-kompatibel
response = client.responses.create(
model="grok-4.5",
input="Tech trends on X this week",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
import { xai } from '@ai-sdk/xai';
const response = await generateText({
model: xai.responses('grok-4.5'),
prompt: 'Tech trends on X this week',
tools: [xai.tools.xSearch()]
});
Kombinér web_search og x_search
Du kan aktivere begge værktøjer samtidigt for at få et komplet overblik over et emne. Modellen vil vælge det mest relevante værktøj eller bruge begge, hvis det er nødvendigt:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
I dette tilfælde kan modellen søge efter presseartikler via web_search og realtidsreaktioner via x_search for derefter at syntetisere begge perspektiver i sit svar.
Praktisk øvelse
Opret et script, der bruger x_search til at overvåge diskussioner omkring et fagligt emne, der interesserer dig. Test med forespørgsler om aktuelle begivenheder og observer, hvordan modellen syntetiserer meninger og fakta fra X.
Vigtige pointer
x_search-værktøjet aktiveres med{"type": "x_search"}itools-arrayet- Det understøtter fire søgetyper: nøgleord, semantik, brugere og tråde
- Omkostningerne er identiske med
web_search: $5 pr. 1.000 kald - Begge værktøjer kan aktiveres samtidigt for fuld dækning
- Videoforståelse er eksklusivt for
x_search(fraværende iweb_search)