{
  "x402Version": 2,
  "id": 4335,
  "slug": "4335",
  "resource": "https://twitr.sh/api/tools/x_read",
  "description": "Read live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media. Pay per call in USDC — no API key, no signup; failed calls are never charged.",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "2400",
      "maxTimeoutSeconds": 60
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "4u4TLWUqr4296NFpUohqJELAfZLbkxThwX8UALxh6M7o",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "2400",
      "maxTimeoutSeconds": 60
    }
  ],
  "outputSchema": {
    "bazaar": {
      "category": "api",
      "discoverable": true,
      "info": {
        "input": {
          "body": {
            "id": "2079908425904042170",
            "resource": "get-tweet"
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "example": {
            "duration": 1,
            "items": [
              {
                "authorUsername": "vercel",
                "createdAt": "2026-02-24T10:05:00.000Z",
                "id": "2079908425904042170",
                "likeCount": 4210,
                "retweetCount": 512,
                "text": "Ship early, ship often."
              }
            ],
            "payment": {
              "amount": "0.001200",
              "currency": "USD",
              "protocol": "x402"
            },
            "runId": "tw_example"
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "body": {
                "allOf": [
                  {
                    "if": {
                      "properties": {
                        "resource": {
                          "const": "followers-you-know"
                        }
                      }
                    },
                    "then": {
                      "required": [
                        "resultsLimit"
                      ]
                    }
                  }
                ],
                "properties": {
                  "count": {
                    "description": "trends: number of trends to return.",
                    "type": "integer"
                  },
                  "id": {
                    "description": "Tweet ID, user ID, or username (depends on resource).",
                    "type": "string"
                  },
                  "ids": {
                    "description": "batch-tweets|batch-users: up to 100 tweet IDs or user IDs/usernames.",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "resource": {
                    "description": "Which read operation to run.",
                    "enum": [
                      "get-tweet",
                      "get-user",
                      "batch-tweets",
                      "batch-users",
                      "check-follower",
                      "trends",
                      "article",
                      "followers-you-know",
                      "download-media"
                    ],
                    "type": "string"
                  },
                  "resultsLimit": {
                    "description": "Mandatory for followers-you-know: max results, billed per result.",
                    "maximum": 10000,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "source": {
                    "description": "check-follower: source username.",
                    "type": "string"
                  },
                  "target": {
                    "description": "check-follower: target username.",
                    "type": "string"
                  },
                  "woeid": {
                    "description": "trends: region WOEID (default 1 = worldwide).",
                    "type": "integer"
                  }
                },
                "required": [
                  "resource"
                ],
                "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"
      },
      "tags": [
        "twitter",
        "x",
        "social",
        "tweet",
        "user",
        "profile",
        "lookup",
        "get-tweet",
        "followers",
        "trends",
        "media",
        "agent",
        "x402"
      ]
    }
  },
  "tags": [
    "bazaar"
  ],
  "sourceHost": "twitr.sh",
  "lastUpdated": "2026-09-15T17:36:15.07Z",
  "quality": {
    "calls30d": 8,
    "uniquePayers30d": 4,
    "lastCalledAt": "2026-09-15T17:36:14.751Z"
  },
  "liveness": {},
  "verified": false,
  "featured": false,
  "provider": {
    "host": "twitr.sh",
    "manifest_name": "twitr.sh",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-09-18T22:00:31.484Z"
  }
}