Tool detail

x_timeline

Fetches an X/Twitter account's tweets, replies, likes, media, mentions, followers/following, or a tweet's engagement lists, billed per item returned.

Categories: Social media

Use when

fetch a user's recent tweets or replies on X
list an account's followers or following on X
see who liked, retweeted or quoted a specific tweet
pull a user's media posts or mentions from X

Not for

not keyword search across X — a fixed account/tweet lookup only
not posting or writing to X — read only

Inputs

POST JSON body: kind (enum e.g. user-tweets/followers/tweet-replies, required), id (string, required), resultsLimit (integer 1-10000, required); optional includeReplies, mediaType, minFaves, verifiedOnly

Admitted input schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "User ID/username or tweet ID (depends on kind)."
    },
    "includeParentTweet": {
      "type": "boolean"
    },
    "includeReplies": {
      "type": "boolean"
    },
    "kind": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "user-tweets",
        "user-replies",
        "user-likes",
        "user-media",
        "user-mentions",
        "followers",
        "following",
        "verified-followers",
        "tweet-replies",
        "tweet-quotes",
        "tweet-thread",
        "tweet-favoriters",
        "tweet-retweeters"
      ],
      "description": "Which timeline to fetch."
    },
    "language": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096
    },
    "mediaType": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "images",
        "videos",
        "gifs",
        "media"
      ]
    },
    "minFaves": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "resultsLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "description": "MANDATORY: max items returned, billed per item."
    },
    "verifiedOnly": {
      "type": "boolean"
    }
  },
  "required": [
    "kind",
    "id",
    "resultsLimit"
  ],
  "additionalProperties": false
}

Endpoint

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

Payment

Protocol: x402
Listed price: 0.12 USDC per call on Base (billed per item; varies with resultsLimit)
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

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