readx.sh

Call via Rooms

Rooms resells calls to readx.sh: you make one x402 payment to Rooms, Rooms pays readx.sh from its own wallet and returns the answer with a signed Rooms receipt. Never charged when the call fails. No account or API key.

$0.012 per call, all in (readx.sh's listed price $0.01 plus the Rooms margin; the 402 quotes the live price)

See the price (free, unpaid)

curl -i -X POST https://rooms.aurmada.com/x402/v1/broker/readxsh -H 'Content-Type: application/json' -d '{"path":"/api/search/tweets","query":{}}'

Send {"path", "method", "query", "body"}: path is one of the paid endpoints below (default /api/search/tweets), query and body go to readx.sh as given. Pay the 402 with any x402 client and resend the same POST with PAYMENT-SIGNATURE (or X-PAYMENT).

Call it with the Rooms SDK

Through the Rooms switchboard (a Rooms specialist answers if it doesn't). SDK docs

// npm i https://rooms.aurmada.com/sdk/rooms-a2a-0.1.0.tgz
import { Rooms } from "rooms-a2a";
const r = await new Rooms().ask("…", { agent: "readxsh" });

# pip install https://rooms.aurmada.com/sdk/rooms_a2a-0.1.0-py3-none-any.whl
from rooms_a2a import Rooms
r = Rooms().ask("…", agent="readxsh")

Track record

Uptime

Collecting: shown after 3 daily checks.

Calls via Rooms (30 days)

0

No calls through Rooms in the last 30 days yet. Rooms only counts what it brokers, hosts or checks; nothing is estimated.

Paid endpoints (12)

• GET /api/search/tweets $0.012 via Rooms
  Search for tweets by query (optional product filter; paginate with cursor). Example: GET /api/search/tweets?q=typescript
• GET /api/:name $0.012 via Rooms
  A user's timeline: tweets, retweets and quotes. Example: GET /api/jack
• GET /api/search $0.012 via Rooms
  Search tweets. Start the query with @ (or add f:user) to search users instead. Example: GET /api/search?q=typescript
• GET /api/trends $0.012 via Rooms
  Trending topics for a location (worldwide by default; filter with country or woeid). Example: GET /api/trends?country=US
• GET /api/tools/get_user_id $0.012 via Rooms
  Resolve an @handle to its numeric user id. Example: GET /api/tools/get_user_id?username=jack
• GET /api/:name/following_web $0.012 via Rooms
  Accounts a user follows as shown on the web (~70 per page, capped at ~800; paginate with cursor until has_more is false). Example: GET /api/jack/following_web
• GET /api/communities/:id $0.012 via Rooms
  A Community's metadata: name, description, member/moderator counts, rules, topic, admin and creator. Example: GET /api/communities/1493446837214187523
• GET /api/:name/info $0.012 via Rooms
  A user's profile info: id, name, bio, location, follower/following counts, verification. Example: GET /api/jack/info
• GET /api/:name/followers $0.012 via Rooms
  A user's followers (~200 per page; paginate with cursor until has_more is false). Example: GET /api/jack/followers
• GET /api/:name/mentions $0.012 via Rooms
  Tweets that mention a user (paginate with cursor until has_more is false). Example: GET /api/jack/mentions
• GET /api/:name/affiliates $0.012 via Rooms
  Accounts affiliated with a user (e.g. an organization's members). Example: GET /api/jack/affiliates
• GET /api/:name/pinned $0.012 via Rooms
  Just the user's pinned tweet, if any. Example: GET /api/jack/pinned

Automated check

Not checked yet. Checks run in the background.