SocialFetch · Twitter Tweets

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://api.socialfetch.dev/v1/twitter/tweets", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.socialfetch.dev/v1/twitter/tweets?url=https%3A%2F%2Fx.com%2Felonmusk%2Fstatus%2F2044990537145753894" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data": {
    "author": {
      "metrics": {
        "fastFollowersCount": 0,
        "favourites": 227796,
        "followers": 239969612,
        "following": 1332,
        "listedCount": 169024,
        "mediaCount": 4489,
        "tweets": 102641
      },
      "profile": {
        "_truncated": true,
        "accountCreatedAt": "2009-06-02T20:12:29.000Z",
        "avatarUrl": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_400x400.jpg",
        "bannerUrl": "https://pbs.twimg.com/profile_banners/44196397/1774145451",
        "bio": "https://t.co/dDtDyVssfm",
        "blueVerified": true,
        "displayName": "Elon Musk",
        "handle": "elonmusk",
        "platform": "twitter",
        "platformUserId": "44196397",
        "privateAccount": false,
        "profileUrl": "https://x.com/elonmusk",
        "verified": false
      }
    },
    "lookupStatus": "found",
    "tweet": {
      "_truncated": true,
      "conversationId": "2044683867630833961",
      "createdAt": "2026-04-16T07:46:37.000Z",
      "displayTextRange": [
        0
      ],
      "entities": {
        "hashtags": [],
        "symbols": [],
        "urls": [],
        "userMentions": []
      },
      "id": "2044683867630833961",
      "isLongForm": false,
      "isReply": false,
      "language": "en",
      "media": [],
      "metrics": {
        "bookmarks": 1371,
        "favorites": 41905,
        "quotes": 94,
        "replies": 2809,
        "retweets": 4590,
        "views": 21703034
      },
      "text": "Look at the tiny cars in the foreground to get a sense of the vastness of the building",
      "url": "https://x.com/elonmusk/status/2044683867630833961"
    }
  },
  "meta": {
    "creditsCharged": 1,
    "requestId": "req_498736a9-e0e8-4adc-9100-a59e8bbcd452",
    "version": "v1"
  }
}