Skip to content

X · Posts since 2006

Full-archive search

X (Twitter) full-archive search: posts since 2006. At most one of `start_time`, `since_id` may be provided. Same operators as the recent search; use start_time and end_time (ISO 8601) to bound the period. Price: $0.005 per post returned or hydrated, $0.01 per user hydrated (expansions). 10 to 500 posts per page. Billed on the resources actually returned (posts and users), the quote is the upper bound; X's 24-hour deduplication is not passed through.

Usage based XSocialx/search-allListed

Activation pending; your agent will see it as unavailable until then.

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool x/search-all (X (Twitter) full-archive search: posts since 2006). Call inspect_tool with {"tool_id": "x/search-all"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "x/search-all" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
querystringYes
start_timestringNo
end_timestringNo
since_idstringNo
until_idstringNo
max_resultsintegerNo
next_tokenstringNoA base32hex-encoded pagination token.
pagination_tokenstringNoA base32hex-encoded pagination token.
sort_orderstringNoOptions: recency, relevancy.
post.fieldsstring[]NoThe fields available for a Post object.
expansionsstring[]NoA comma separated list of fields to expand.
user.fieldsstring[]NoThe fields available for a User object.
media.fieldsstring[]NoThe fields available for a Media object.
poll.fieldsstring[]NoThe fields available for a Poll object.
place.fieldsstring[]NoThe fields available for a Place object.

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "x/search-all",
  "input": {
    "query": "from:X -is:retweet",
    "max_results": 10
  }
}

Price and billing

Price
Usage based
Model
Usage based
Detail
Billed at the cost the provider reports for the call, never above $12. Your agent sees the maximum before running.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.