Tool detail

botsmith

Searches X/Twitter with full advanced-search syntax and returns up to 20 posts as JSON with metrics, entities and a paging cursor.

Categories: Social media

Use when

search tweets using from:/since:/until: advanced X search syntax
monitor recent posts matching a boolean or exact-phrase query
paginate through X search results with a cursor

Not for

not a single tweet or user lookup (see /x/tweet, /x/user on this host)

Inputs

GET query: query (string 1-400 chars, required, advanced-search syntax), type (Latest|Top, required, default Latest), cursor (optional)

Admitted input schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^[A-Za-z0-9+/=_-]{1,400}$",
      "description": "Pagination cursor from a previous call"
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 400,
      "description": "Search query, e.g. \"x402 from:coinbase since:2026-07-01\""
    },
    "type": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "Latest",
        "Top"
      ],
      "description": "Sort by recency or engagement",
      "default": "Latest"
    }
  },
  "required": [
    "query",
    "type"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://x402.botsmith.dev/x/search

Payment

Protocol: x402
Listed price: 0.02 USDC per call on Base (eip155:8453)
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://x402.botsmith.dev/x/search
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z