Index onlineMerchant portal
Api Endpoint

twitr.sh

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.

Open interactive test console

Offering

Provider
twitr.sh
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://twitr.sh/api/tools/x_timeline
MIME type
Not provided
First seen
2026-10-16T01:52:13.818Z
Last seen
Tags
None supplied

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.12 USDC
Atomic price: 120000 · Network: eip155:8453 · Asset: USDC · Scheme: upto
Raw x402 terms
[
  {
    "scheme": "upto",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "120000",
    "payTo": "0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A"
  }
]

Observed health

Status
Healthy
Latest latency
97 ms
Average latency
216 ms
HTTP status
204
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "body": {
    "id": "elonmusk",
    "kind": "user-tweets",
    "resultsLimit": 100
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "id": {
              "description": "User ID/username or tweet ID (depends on kind).",
              "type": "string"
            },
            "includeParentTweet": {
              "type": "boolean"
            },
            "includeReplies": {
              "type": "boolean"
            },
            "kind": {
              "description": "Which timeline to fetch.",
              "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"
              ],
              "type": "string"
            },
            "language": {
              "type": "string"
            },
            "mediaType": {
              "enum": [
                "images",
                "videos",
                "gifs",
                "media"
              ],
              "type": "string"
            },
            "minFaves": {
              "type": "integer"
            },
            "resultsLimit": {
              "description": "MANDATORY: max items returned, billed per item.",
              "maximum": 10000,
              "minimum": 1,
              "type": "integer"
            },
            "verifiedOnly": {
              "type": "boolean"
            }
          },
          "required": [
            "kind",
            "id",
            "resultsLimit"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "duration": {
              "description": "Run duration in seconds.",
              "type": "integer"
            },
            "items": {
              "description": "Returned items. Shape varies per tool — see each tool's outputSample for a concrete example.",
              "items": {
                "type": "object"
              },
              "type": "array"
            },
            "payment": {
              "description": "Settlement summary (protocol, amount, currency).",
              "type": "object"
            },
            "runId": {
              "description": "Run ID for debugging/audit.",
              "type": "string"
            }
          },
          "required": [
            "items"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}