Skip to content

X search actions

1 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.

x.search · read

Live X search, one page of up to 20 posts. A sample, not every match.

  • MCP tool: search_x. Loaded by default in MCP clients.
  • REST: GET /v1/x/search
  • CLI: xholic x search
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Live X lookup: no credits, counts toward the plan’s X data limits.
  • Rate limit bucket: live_x

Input

Field Type Required Description
query string ≤ 500 chars Yes
sort “Latest” \ “Top” No
account string ≤ 64 chars No X account to act on, as @handle. Leave it out to use the connection’s default account.