Włącz wyszukiwanie X do badań na Twitterze
Na tej stronie
Dostęp do strumienia czasu rzeczywistego X przez Twoje API
X (dawniej Twitter) pozostaje główną platformą dla informacji w czasie rzeczywistym: ogłoszeń firmowych, reakcji na wiadomości, rodzących się trendów i debat publicznych. Narzędzie x_search w API Grok pozwala odpytywać ten strumień bezpośrednio z Twoich aplikacji, bez konieczności posiadania osobnej subskrypcji API X czy zarządzania dodatkowymi usługami.

Podczas gdy przestarzały punkt końcowy Chat Completions oferował parametr sources: ["x"] w search_parameters, API Responses udostępnia dedykowane narzędzie o znacznie precyzyjniejszych możliwościach filtrowania.
Włączanie wyszukiwania X
Włączanie działa na tej samej zasadzie co web_search. Dodajesz narzędzie x_search do tablicy 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)
Model automatycznie decyduje, kiedy odpytać X, w zależności od charakteru Twojego promptu. Pytania dotyczące bieżących wydarzeń, opinii publicznej lub trendów naturalnie uruchomią wyszukiwanie.
Cztery możliwości wyszukiwania X
Narzędzie x_search wykracza poza proste wyszukiwanie słów kluczowych. Oferuje cztery tryby zapytań:
- Wyszukiwanie słów kluczowych: znajdź wpisy zawierające konkretne terminy
- Wyszukiwanie semantyczne: znajdź wpisy związane z koncepcją, nawet bez dokładnych słów
- Wyszukiwanie użytkowników: zidentyfikuj odpowiednie konta dotyczące danego tematu
- Pobieranie wątków: odtwórz kompletne wątki dyskusyjne
Model automatycznie wybiera najbardziej odpowiedni tryb na podstawie Twojego żądania. Nie musisz jawnie określać, którego trybu użyć.
Użycie z różnymi SDK
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
Kompatybilne z OpenAI SDK
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()]
});
Łączenie web_search i x_search
Możesz włączyć oba narzędzia jednocześnie, aby uzyskać pełny obraz tematu. Model wybierze najbardziej odpowiednie narzędzie lub użyje obu, jeśli będzie to konieczne:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
W takim przypadku model może wyszukać artykuły prasowe przez web_search, a reakcje w czasie rzeczywistym przez x_search, a następnie syntezować obie perspektywy w swojej odpowiedzi.
Ćwiczenia praktyczne
Stwórz skrypt wykorzystujący x_search do monitorowania dyskusji wokół interesującego Cię tematu zawodowego. Przetestuj zapytania dotyczące bieżących wydarzeń i obserwuj, jak model syntezuje opinie i fakty z X.
Kluczowe wnioski
- Narzędzie
x_searchaktywuje się poprzez{"type": "x_search"}w tablicytools - Obsługuje cztery typy wyszukiwania: słowa kluczowe, semantyczne, użytkowników i wątki
- Koszt jest identyczny jak w przypadku
web_search: 5 USD za 1000 wywołań - Oba narzędzia można włączyć jednocześnie, aby uzyskać pełne pokrycie
- Rozumienie wideo jest wyłącznością
x_search(nie występuje wweb_search)