Twitr · Tools X Search

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://twitr.sh/api/tools/x_search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "language": "en",
    "minFaves": 100,
    "q": "artificial intelligence",
    "resultsLimit": 50,
    "type": "search-tweets"
  }),
});
const data = await res.json();

curl -X POST \
  "https://twitr.sh/api/tools/x_search" \
  -H "Content-Type: application/json" \
  -d '{"language":"en","minFaves":100,"q":"artificial intelligence","resultsLimit":50,"type":"search-tweets"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "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"
}