Ota X-haku käyttöön Twitter-tutkimusta varten
Tällä sivulla
Käytä X:n reaaliaikaista syötettä API:n kautta
X (entinen Twitter) on edelleen ensisijainen alusta reaaliaikaiselle tiedolle: yritystiedotteet, reaktiot uutisiin, nousevat trendit ja julkinen keskustelu. Grok API:n x_search-työkalun avulla voit hakea tästä syötteestä suoraan omista sovelluksistasi ilman erillistä X API -tilausta tai lisätilausten hallintaa.

Missä vanha Chat Completions -päätepiste tarjosi parametrin sources: ["x"] kohdassa search_parameters, Responses API tarjoaa erillisen työkalun, jossa on huomattavasti tarkemmat suodatusmahdollisuudet.
Ota X-haku käyttöön
Käyttöönotto noudattaa samaa periaatetta kuin web_search. Lisäät x_search-työkalun tools-taulukkoon:
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)
Malli päättää automaattisesti, milloin X:ää kysytään kehotteesi luonteen perusteella. Kysymykset ajankohtaisista tapahtumista, yleisestä mielipiteestä tai trendeistä laukaisevat haun luonnostaan.
X-haun neljä ominaisuutta
x_search-työkalu menee pelkkää avainsanahakua pidemmälle. Se tarjoaa neljä kyselytilaa:
- Avainsanahaku: löytää viestejä, jotka sisältävät tiettyjä termejä
- Semanttinen haku: löytää viestejä, jotka liittyvät käsitteeseen, vaikka tarkkoja sanoja ei käytettäisi
- Käyttäjähaku: tunnistaa aiheeseen liittyviä tilejä
- Keskusteluketjun nouto: rakentaa uudelleen完整的 keskusteluketjut
Malli valitsee automaattisesti sopivimman tilan pyyntösi perusteella. Sinun ei tarvitse määrittää käytettävää tilaa erikseen.
Käyttö eri SDK:iden kanssa
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
OpenAI SDK -yhteensopiva
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()]
});
Yhdistä web_search ja x_search
Voit ottaa molemmat työkalut käyttöön samanaikaisesti saadaksesi kokonaiskuvan aiheesta. Malli valitsee merkityksellisimmän työkalun tai käyttää molempia tarvittaessa:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
Tällöin malli voi hakea lehdistöartikkeleita web_search-työkalulla ja reaaliaikaisia reaktioita x_search-työkalulla sekä syntetisoida molemmat näkökulmat vastaukseensa.
Käytännön harjoitus
Luo skripti, joka käyttää x_search-työkalua seuraamaan sinua kiinnostavan ammatillisen aiheen ympärillä käytävää keskustelua. Testaa ajankohtaisilla kyselyillä ja tarkkaile, miten malli syntetisoi X:n mielipiteitä ja faktoja.
Keskeiset asiat
x_search-työkalu aktivoituu lisäämällä{"type": "x_search"}tools-taulukkoon- Se tukee neljää hakutyyppiä: avainsanat, semanttinen haku, käyttäjät ja keskusteluketjut
- Hinta on sama kuin
web_search: 5 dollaria per 1 000 pyyntöä - Molemmat työkalut voidaan ottaa käyttöön samanaikaisesti kattavan kuvan saamiseksi
- Videoiden ymmärtäminen on
x_search-työkalun yksinoikeus (ei saatavillaweb_search-työkalussa)