Farcaster user search · FC User Search

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://agent402.tools/api/fc-user-search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "limit": 3,
    "q": "example"
  }),
});
const data = await res.json();

curl -X POST \
  "https://agent402.tools/api/fc-user-search" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"q":"example"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "cached": false,
  "count": 1,
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "nextCursor": null,
  "query": "example",
  "rateLimit": {
    "limit": 300,
    "remaining": 299,
    "resetAt": "2026-08-22T13:20:00.000Z"
  },
  "source": "neynar",
  "users": [
    {
      "bio": "Example profile used only to show the response shape.",
      "displayName": "Example User",
      "fid": 3,
      "followerCount": 630338,
      "followingCount": 77,
      "pfpUrl": "https://imagedelivery.net/.../original",
      "powerBadge": false,
      "primaryEthAddress": "0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5",
      "score": 0.99,
      "url": "https://warpcast.com/dwr",
      "username": "example-user"
    }
  ]
}