cursorstring · optionalValue supplied for cursor.
minLength: 1 · maxLength: 2048
Loading tools…
Loading tools…
X
Search public X posts with bounded query, mode, time and pagination controls.
Return at most 100 deduplicated public X posts across at most five direct advanced-search pages, with stable string IDs, canonical URLs, timestamps, authors, entities, metrics, verification, withheld/unavailable state and one-level quoted or reposted context. Each completed supplier page is one billable request covering up to 20 posts, including an empty page. The quote reserves the requested page count; only completed pages are charged. Optional ISO time bounds are translated to supported Unix since_time and until_time operators. This read-only contract accepts no X login, cookies or action credentials.
Agents select this operation with tool ID x.post-search, then check its current inputs and price before a run.
cursorstring · optionalValue supplied for cursor.
minLength: 1 · maxLength: 2048
limitinteger · optionalValue supplied for limit.
minimum: 1 · maximum: 100
max_pagesinteger · optionalMaximum number of result pages to request.
minimum: 1 · maximum: 5
modestring · optionalValue supplied for mode.
enum: Latest, Top
querystring · requiredX advanced-search query without since, until, since_time or until_time operators.
minLength: 1 · maxLength: 200
sincestring · optionalInclusive start; requires until.
format: date-time
untilstring · optionalExclusive end; requires since and a window of at most 31 days.
format: date-time
captured_atstringReturned captured at value.
duplicate_itemsnumberReturned duplicate items value.
has_next_pagebooleanReturned has next page value.
itemsarrayReturned items value.
next_cursorstringReturned next cursor value.
omitted_itemsnumberReturned omitted items value.
pages_fetchednumberReturned pages fetched value.
pagination_stoppednullReturned pagination stopped value.
Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.
{
"tool_id": "x.post-search",
"input": {
"mode": "Latest",
"limit": 20,
"query": "AI agents lang:en",
"since": "2026-07-01T00:00:00.000Z",
"until": "2026-07-08T00:00:00.000Z",
"max_pages": 1
}
}{
"items": [
{
"id": "1950589874029756544",
"url": "https://x.com/public_author/status/1950589874029756544",
"text": "A public post about AI agents.",
"author": {
"id": "1659345642511212544",
"url": "https://x.com/public_author",
"username": "public_author",
"verified": false
},
"metrics": {
"likes": 31,
"views": 2400,
"quotes": 1,
"replies": 2,
"reposts": 4,
"bookmarks": 3
},
"language": "en",
"published_at": "2026-07-03T12:00:00.000Z"
}
],
"captured_at": "2026-08-20T00:00:00.000Z",
"next_cursor": "opaque-next",
"has_next_page": true,
"omitted_items": 0,
"pages_fetched": 1,
"duplicate_items": 0,
"pagination_stopped": null
}invalid_input: The search input was invalid or outside its time, page or result bounds.example: {"mode":"Latest","limit":20,"query":"AI agents lang:en","since":"2026-07-01T00:00:00.000Z","until":"2026-07-08T00:00:00.000Z","max_pages":1}Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.
Connect your first agent to receive $1 trial credit.