78trust / 100

Tools X Timeline

by twitr.sh in News & content

x402 APIPassing, checked 2 h ago

Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking accounts by activity.

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

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
287 ms typical, 326 ms slowest 5%
Last check
2 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://twitr.sh/api/tools/x_timeline" \
  -H "content-type: application/json" \
  -d '{"id":"elonmusk","kind":"user-tweets","resultsLimit":100}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Ftwitr.sh%2Fapi%2Ftools%2Fx_timeline
const res = await pay("https://twitr.sh/api/tools/x_timeline", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"id":"elonmusk","kind":"user-tweets","resultsLimit":100}),
});
console.log(await res.json());

Example input

{
  "id": "elonmusk",
  "kind": "user-tweets",
  "resultsLimit": 100
}

Example output

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

Security scan

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

Recent checks

WhenResultHTTPTimePrice
2 h agoPassed402246 ms$0.12
5 h agoPassed402326 ms$0.12
9 h agoPassed402269 ms$0.12
13 h agoPassed402299 ms$0.12
16 h agoPassed402244 ms$0.12
21 h agoPassed402466 ms$0.12
23 h agoPassed402305 ms$0.12
29 h agoPassed402287 ms$0.12