Get Farcaster User
Look up a Farcaster user by FID, username, or wallet address. Returns profile data including bio, follower count, verified addresses, and power badge status. Ideal for: user verification, social graph analysis, airdrop targeting, profile enrichment.
Catalog action Social
Look up a Farcaster user by FID, username, or wallet address. Returns profile data including bio, follower count, verified addresses, and power badge status. Ideal for: user verification, social graph analysis, airdrop targeting, profile enrichment.
At a Glance
| Field | Value |
|---|---|
| Action ID | get-farcaster-user |
| Category | Social |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | social, farcaster, neynar, user, profile, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
fid | number | No | Farcaster user ID (FID) to look up |
username | string | No | Exact Farcaster username to look up |
address | string | No | Ethereum or Solana address to find associated Farcaster user |
query | string | No | Fuzzy search query to find Farcaster users by partial username or display name |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
fid | number | No | Farcaster user ID (single lookup) |
username | string | No | Farcaster username (single lookup) |
displayName | string | No | Display name |
pfpUrl | string | No | Profile picture URL |
bio | string | No | User bio |
followerCount | number | No | Number of followers |
followingCount | number | No | Number of following |
verifiedAddresses | array | No | Verified wallet addresses |
activeStatus | string | No | Active status |
powerBadge | boolean | No | Whether user has power badge |
users | array | No | List of matching users (returned by query search) |
Examples
json{ "type": "get-farcaster-user", "payload": { "fid": 1, "username": "example-username", "address": "0x0000000000000000000000000000000000000000", "query": "status:open" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/get-farcaster-user/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "fid": 1, "username": "example-username", "address": "0x0000000000000000000000000000000000000000", "query": "status:open" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.