81trust / 100

Fc User Search

by Farcaster user search in Search & web

x402 APIPassing, checked 3 h ago

Search Farcaster users by name or username fragment. Returns up to 10 compact profiles: fid, username, display name, bio, follower and following counts, Neynar quality score, primary verified Ethereum address. Use to resolve a person or brand to a fid before fc-user-casts, or to find who to follow on a topic.

POST https://agent402.tools/api/fc-user-search

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
196 ms typical, 196 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://agent402.tools/api/fc-user-search" \
  -H "content-type: application/json" \
  -d '{"limit":3,"q":"example"}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.03:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fagent402.tools%2Fapi%2Ffc-user-search
const res = await pay("https://agent402.tools/api/fc-user-search", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"limit":3,"q":"example"}),
});
console.log(await res.json());

Example input

{
  "limit": 3,
  "q": "example"
}

Example output

{
  "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"
    }
  ]
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402196 ms$0.003