X user profile

Look up one X (Twitter) account by username: id, display name, bio, account creation date, verification status and type, location, link, protected flag, and public metrics (followers, following, tweet count, listed count).

TRY IN PLAYGROUND →

Input

Example output

{
  "source": "x-api-v2",
  "fetchedAt": "2026-08-20T14:10:00.000Z",
  "user": {
    "id": "574032254",
    "username": "coinbase",
    "name": "Coinbase",
    "description": "The future of money is here.",
    "createdAt": "2012-05-07T23:46:41.000Z",
    "verified": true,
    "verifiedType": "business",
    "location": "Global",
    "url": "https://coinbase.com",
    "protected": false,
    "profileImageUrl": "https://pbs.twimg.com/profile_images/.../normal.jpg",
    "metrics": {
      "followers": 6400000,
      "following": 250,
      "tweets": 19000,
      "listed": 9000
    },
    "profileUrl": "https://x.com/coinbase"
  }
}

Try it - see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/x-user \
  -H "Content-Type: application/json" \
  -d '{"username":"coinbase"}'

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/x-user", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "username": "coinbase"
  }),
});

Related tools