Активиране на търсене в X за изследвания
На тази страница
Достъп до емисията в реално време на X чрез Вашия API
X (предишно име Twitter) остава основната платформа за информация в реално време: обявления на компании, реакции към новини, възникващи тенденции и публични дебати. Инструментът x_search на Grok API Ви позволява да правите заявки директно към тази емисия от Вашите приложения, без да се нуждаете от отделен абонамент за X API или да управлявате допълнителни абонаменти.

Докато старият крайна точка Chat Completions предлагаше параметъра sources: ["x"] в search_parameters, Responses API предоставя специализиран инструмент с много по-фини възможности за филтриране.
Активиране на търсене в X
Активирането следва същия принцип като при web_search. Добавяте инструмента x_search към масива 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)
Моделът автоматично решава кога да прави заявки към X въз основа на естеството на Вашата подкана. Въпросите относно текущи събития, общественото мнение или тенденциите естествено ще задействат търсенето.
Четирите възможности на търсене в X
Инструментът x_search надхвърля простото търсене по ключови думи. Той предлага четири режима на заявка:
- Търсене по ключови думи: намиране на публикации, съдържащи конкретни термини
- Семантично търсене: намиране на публикации, свързани с дадена концепция, дори без точните думи
- Търсене на потребители: идентифициране на релевантни профили по дадена тема
- Извличане на нишки: реконструиране на пълни дискусионни нишки
Моделът автоматично избира най-подходящия режим въз основа на Вашата заявка. Не е необходимо да посочвате изрично кой режим да се използва.
Използване с различни SDK
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
Съвместим с 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()]
});
Комбиниране на web_search и x_search
Можете да активирате двата инструмента едновременно, за да получите цялостна представа за дадена тема. Моделът ще избере най-релевантния инструмент или ще използва и двата, ако е необходимо:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
В този случай моделът може да търси пресови статии чрез web_search и реакции в реално време чрез x_search, след което да синтезира двете гледни точки в своя отговор.
Практическо упражнение
Създайте скрипт, който използва x_search, за да наблюдава дискусии около професионална тема, която Ви интересува. Тествайте със заявки за текущи събития и наблюдавайте как моделът синтезира мнения и факти от X.
Ключови изводи
- Инструментът
x_searchсе активира с{"type": "x_search"}в масиваtools - Поддържа четири типа търсене: ключови думи, семантично, потребители и нишки
- Цената е идентична с тази на
web_search: $5 на 1000 заявки - Двата инструмента могат да бъдат активирани едновременно за пълно покритие
- Разбирането на видео е ексклузивна функция на
x_search(липсва вweb_search)