Twitr · Tools X Timeline

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_timeline", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "id": "elonmusk",
    "kind": "user-tweets",
    "resultsLimit": 100
  }),
});
const data = await res.json();

curl -X POST \
  "https://twitr.sh/api/tools/x_timeline" \
  -H "Content-Type: application/json" \
  -d '{"id":"elonmusk","kind":"user-tweets","resultsLimit":100}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "duration": 3,
  "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.120000",
    "currency": "USD",
    "protocol": "x402"
  },
  "runId": "tw_example"
}