ToolVet
80trust / 100

Tools X Search

by twitr.sh in Search & web

x402 APIPassing, checked 3 h ago

Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.

POST
https://twitr.sh/api/tools/x_search
Price
$0.06
per call in USDC
Uptime
100%
last 30 days
Response time
261 ms
514 ms slowest 5%
Last check
Passed
3 h ago, next any minute now

Run a free test callHow to call it

Reliability

All checks passedSome failedAll failedNot checked

Status and outage history · Atom feed · Watch with other listings

How to call it

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

Each call costs $0.06 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

POST https://twitr.sh/api/tools/x_search
content-type: application/json

{
  "language": "en",
  "minFaves": 100,
  "q": "artificial intelligence",
  "resultsLimit": 50,
  "type": "search-tweets"
}

Parameters

ParameterTypeRequiredDescription
advancedQuerystringNoRaw X search operator string appended to q.
cursorstringNosearch-users: pagination cursor from a previous call's report.next_cursor.
exactPhrasestringNo
excludeWordsstringNo
fromUserstringNo
languagestringNo
mediaTypestringNo One of: images, videos, gifs, media.
minFavesintegerNo
minRepliesintegerNo
minRetweetsintegerNo
qstringYesSearch query (X operator syntax supported for tweets).
resultsLimitintegerNosearch-tweets: MANDATORY max tweets returned, billed per tweet.
sinceDatestringNoYYYY-MM-DD
typestringNoSearch tweets (default) or users. One of: search-tweets, search-users.
untilDatestringNoYYYY-MM-DD
verifiedOnlybooleanNo

Example response

The provider's example. We can't check it without paying.

{
  "duration": 2,
  "items": [
    {
      "authorUsername": "elonmusk",
      "createdAt": "2026-02-24T10:05:00.000Z",
      "id": "1893710452812718080",
      "likeCount": 1180,
      "text": "This is a great thread, thanks for sharing."
    }
  ],
  "payment": {
    "amount": "0.060000",
    "currency": "USD",
    "protocol": "x402"
  },
  "runId": "tw_example"
}

Call it from code

The curl command shows the payment challenge.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://twitr.sh/api/tools/x_search' \
  -H 'content-type: application/json' \
  --data-raw '{"language":"en","minFaves":100,"q":"artificial intelligence","resultsLimit":50,"type":"search-tweets"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://twitr.sh/api/tools/x_search' \
  -H 'content-type: application/json' \
  --data-raw '{"language":"en","minFaves":100,"q":"artificial intelligence","resultsLimit":50,"type":"search-tweets"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

We don't show code that pays this service: it uses a payment scheme other than exact, which needs a different client setup.

Security scan

No findings

We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402366 ms$0.06
8 h agoPassed402228 ms$0.06
13 h agoPassed402213 ms$0.06
17 h agoPassed402232 ms$0.06
22 h agoPassed402318 ms$0.06
Show 10 older checks
26 h agoPassed402228 ms$0.06
30 h agoPassed402207 ms$0.06
34 h agoPassed402245 ms$0.06
39 h agoPassed402514 ms$0.06
43 h agoPassed402287 ms$0.06
47 h agoPassed402222 ms$0.06
2 days agoPassed402242 ms$0.06
2 days agoPassed402304 ms$0.06
2 days agoPassed402234 ms$0.06
3 days agoPassed402560 ms$0.06