x_search
Perform read-only research on X/Twitter using natural language queries. Filter by date, include or exclude specific handles, and enable image or video understanding for richer insights.
Instructions
Free-form read-only X/Twitter research using xAI Responses API x_search.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "x_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to look up on X. | |
| to_date | No | Optional YYYY-MM-DD end date. | |
| from_date | No | Optional YYYY-MM-DD start date. | |
| allowed_x_handles | No | Optional X handles to include exclusively, max 10. | |
| excluded_x_handles | No | Optional X handles to exclude, max 10. | |
| enable_image_understanding | No | ||
| enable_video_understanding | No |