X(Twitter) tools

X(Twitter)twitter_post_search

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

Claude CodeCodexCursor

Download and install the dedicated Mouter Skill for “X post search”: https://mouter.ai/skills/twitter_post_search.zip

Pricing

How credits work

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:

  1. platformtext
  2. itemslist: audio_tracks, music, topics, id, url
  3. paginationobject: has_more, next_cursor, total
  4. retrieved_atnumber
  5. 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.