Skip to content
onelayer.
All tools

Tool detail

x_search

Searches X/Twitter tweets or user profiles by keyword, operators, filters and date range, billed per tweet returned.

Categories: Social media

Use when

  • search tweets by keyword, hashtag or X search operators
  • track what people say about a brand, topic or ticker on X in real time
  • search X/Twitter user profiles by keyword

Not for

  • not bulk export — see twitr.sh's separate X/Twitter Bulk Export tool for that
  • not account monitoring/alerts — see its separate X/Twitter Monitor tool for that

Inputs

POST JSON body: q (string, required); resultsLimit (int 1-10000, required for tweet search); optional fromUser, language, dates, mediaType, type

Inputs undocumented: unsupported schema construct: allOf

Endpoint

Method
POST
URL
https://twitr.sh/api/tools/x_search

Payment

Protocol
x402
Listed price
0.06 USDC per call on Base (billed per tweet returned)
Payment method
upto
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

Record
POST https://twitr.sh/api/tools/x_search
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z