Aktivera X-sökning för forskning på Twitter
På denna sida
Få tillgång till X:s realtidsflöde via ditt API
X (tidigare Twitter) är fortfarande den främsta plattformen för realtidsinformation: företagsmeddelanden, reaktioner på nyheter, framväxande trender och offentliga debatter. Grok API:s verktyg x_search låter dig fråga detta flöde direkt från dina applikationer, utan att behöva ett separat X API-abonnemang eller hantera ytterligare prenumerationer.

Där den äldre Chat Completions-endpointen erbjöd parametern sources: ["x"] i search_parameters, tillhandahåller Responses API ett dedikerat verktyg med betydligt finare filtreringsmöjligheter.
Aktivera X-sökning
Aktiveringen följer samma princip som för web_search. Du lägger till verktyget x_search i arrayen tools:
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 avgör automatiskt när den ska fråga X baserat på din prompts natur. Frågor om aktuella händelser, allmän opinion eller trender utlöser naturligtvis en sökning.
De fyra funktionerna hos X-sökning
Verktyget x_search går bortom enkel nyckelordssökning. Det erbjuder fyra frågelägen:
- Nyckelordssökning: hitta inlägg som innehåller specifika termer
- Semantisk sökning: hitta inlägg relaterade till ett koncept, även utan exakta ord
- Användarsökning: identifiera relevanta konton inom ett ämne
- Trådhämtning: återskapa kompletta diskussionstrådar
Modellen väljer automatiskt det lämpligaste läget baserat på din begäran. Du behöver inte ange vilket läge som ska användas explicit.
Användning med olika SDK:n
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()]
});
Kombinera web_search och x_search
Du kan aktivera båda verktygen samtidigt för att få en helhetsbild av ett ämne. Modellen väljer det mest relevanta verktyget, eller använder båda om det behövs:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
I detta fall kan modellen söka efter pressartiklar via web_search och realtidsreaktioner via x_search, för att sedan syntetisera båda perspektiven i sitt svar.
Praktisk övning
Skapa ett skript som använder x_search för att övervaka diskussioner kring ett professionellt ämne som intresserar dig. Testa med frågor om aktuella händelser och observera hur modellen syntetiserar åsikter och fakta från X.
Viktiga punkter
- Verktyget
x_searchaktiveras med{"type": "x_search"}i arrayentools - Det stöder fyra söktyper: nyckelord, semantisk, användare och trådar
- Kostnaden är densamma som för
web_search: $5 per 1 000 anrop - Båda verktygen kan aktiveras samtidigt för fullständig täckning
- Videoförståelse är exklusivt för
x_search(finns inte iweb_search)