X post search
Search X (Twitter) posts by keyword to find brand mentions, collect industry news and research public discussion around current events, with sorting and pagination.
Start with your agent
Download and install the dedicated Mouter Skill for “X post search”: https://mouter.ai/skills/twitter_post_search.zip
Pricing
0.01 credits per call
Each additional page is billed as a separate call.
Usage example
Agent
Example input
Use twitter_post_search. Look up X post search using query travel guide and summarize matching content, sources and pagination. Confirm inputs and estimated cost before running.
Example output
Example only: X post search has not been run. Once a task succeeds, its result contains these fields:
- platformtext
- itemslist: audio_tracks, music, topics, id, url
- paginationobject: has_more, next_cursor, total
- retrieved_atnumber
- querytext
Values depend on your input. The matching JSON example structure is in the API tab.
Continue this example
For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch. Illustrative requests and response fragment; no calls are executed.
1. Initial request
{
"name": "twitter_post_search",
"arguments": {
"query": "travel guide"
}
}2. Returned continuation
{
"pagination": {
"next_cursor": "<NEXT_CURSOR>",
"has_more": true
}
}3. Follow-up request
{
"name": "twitter_post_search",
"arguments": {
"query": "travel guide",
"cursor": "<NEXT_CURSOR>"
}
}- Getting started: provide search term. Adjust sort order, continuation cursor as needed.
FAQ
Can I search recent posts or media on X?
Yes. Provide query with 1–512 characters and set order to top, latest or media. The default is top. Results use items and can include text, author, media, engagement statistics and conversation context where available.
How do I fetch the next page of X posts?
Start without cursor. Continue with pagination.next_cursor while pagination.has_more is true, keeping query and order unchanged. Each page is billed as a separate call. The tool exposes no dedicated country or region parameter.
Can X Post Search filter by country or region?
The tool exposes query, order and cursor, with no dedicated country or region parameter.
How is X post search billed for each request?
Published reference rates: Standard rate: 0.01 credits · Per call. Each additional page is billed as a separate call. Final charges use your account’s rates and actual usage.