Tool detail

ReadX

Searches X/Twitter for tweets matching a query, with an optional result-ordering filter and cursor pagination.

Categories: Social media, Web search

Use when

find recent tweets matching a keyword or topic
search X/Twitter and sort results by top or latest
paginate through additional pages of tweet search results

Not for

not a single user's timeline, use /api/{handle} for that
not full reply threads, use the conversation endpoint instead

Inputs

GET query params: q (string, required, search query), product (string, optional, e.g. Top/Latest), cursor (string, optional, pagination)

Admitted input schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Pagination cursor from a previous response's pagination.next_cursor (the conversation endpoint at /api/{name}/tweets/{id} instead takes its own nested reply cursor — see that endpoint)."
    },
    "product": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Result ordering, e.g. Top or Latest."
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Tweet search query."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://readx.sh/api/search/tweets

Payment

Protocol: x402
Listed price: $0.01 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://readx.sh/api/search/tweets
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z