Tool detail

search

Searches X/Twitter for tweets matching word, phrase, hashtag, user or engagement-count filters, returning up to 20 results per page.

Categories: Social media

Use when

find recent tweets mentioning a keyword or hashtag
search tweets from a specific X user with minimum likes
page through tweet search results with a cursor

Not for

not full tweet threads or conversation context
not user profile lookup - tweet search only

Inputs

GET query params (all string; at least one filter required): words, phrase, anyWords, noneWords, hashtags, from, to, mentioning, minLikes, minReplies, minReposts, since, until, next_token.

Admitted input schema

{
  "type": "object",
  "properties": {
    "anyWords": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Any of these words"
    },
    "from": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Tweets from this username"
    },
    "hashtags": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Filter by hashtag"
    },
    "mentioning": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Tweets mentioning this username"
    },
    "minLikes": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum like count"
    },
    "minReplies": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum reply count"
    },
    "minReposts": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum retweet count"
    },
    "next_token": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Pagination cursor"
    },
    "noneWords": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Exclude these words"
    },
    "phrase": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Exact phrase match"
    },
    "since": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Start date (YYYY-MM-DD)"
    },
    "to": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Tweets replying to this username"
    },
    "until": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "End date (YYYY-MM-DD)"
    },
    "words": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "All these words must appear"
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://x402.twit.sh/tweets/search

Payment

Protocol: x402
Listed price: 0.006 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://x402.twit.sh/tweets/search
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z