402.bot · twit.sh Tweet Search & Normalize
Search X/Twitter posts with structured operators and receive pre-normalized, token-efficient result sets for agent consumption.
What it does
Search X/Twitter posts with structured operators and receive pre-normalized, token-efficient result sets for agent consumption.
- Monitor market sentiment with compact tweet data
- Track trending topics with normalized social signals
- Feed social data to LLMs with minimal context usage
Ideal buyer
AI agents and social listening tools needing efficient, structured X data without raw HTML parsing overhead.
Run this through your governed agent wallet.
- 01Bootstrap AXON once with
npx @axon402/init. - 02Use the AXON runtime MCP tools to
search_x402_servicesorinspect_x402_offerfor this service. - 03Quote, test-buy, then run the governed paid fetch through AXON.
Send this
Prompt for your agent
A natural-language instruction for your LLM agent — with this endpoint exposed as a tool — to call this resource. Not sent to the endpoint; the endpoint consumes the JSON body below.
Pasting this prompt into a raw ChatGPT or unconfigured agent will notexecute the paid endpoint flow. Run it through an agent with the AXON runtime / MCP tools exposed (see “Use with AXON” above) so the 402 challenge, quote, and governed fetch are handled for you.
“Search for tweets about Bitcoin price with at least 10 likes from the last 24 hours.”
Endpoint request body
The JSON payload your agent sends to the endpoint.
{
"query": "Bitcoin price min_faves:10",
"time_range": "24h"
}Advanced HTTP details
For integrators who need the raw protocol surface. Most agents should use AXON above instead of calling these directly.
curl fallback
curl https://api.402.bot/v1/alchemist/fetch-transform/twitsh-tweet-search/probe \ -H "Content-Type: application/json" \ -H "X-PAYMENT: [signed_payment_envelope]" \ -d '{"query":"Bitcoin price min_faves:10","time_range":"24h"}'
Payment & settlement details
Raw on-chain settlement parameters. AXON above handles these automatically through quote / test-buy / governed fetch.
Price & network
Trust & risk
More in Data APIs
Browse all →Other resources in this category
Category proxy — we don't track live co-purchase signals yet.