{"uid":"cap_XylaXa_w2KvqGgYgdp1m-","slug":"agent402-farcaster-user-search-5ea03868","name":"Agent402 Farcaster User Search","description":"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.","url":"https://agent402.tools/api/fc-user-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"Name or username fragment (1-100 chars)."},"limit":{"type":"integer","maximum":10,"minimum":1,"description":"Results per page (default 5)."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous call's nextCursor."}}},"responseSchema":{"type":"json","example":{"count":1,"query":"example","users":[{"bio":"Example profile used only to show the response shape.","fid":3,"url":"https://warpcast.com/dwr","score":0.99,"pfpUrl":"https://imagedelivery.net/.../original","username":"example-user","powerBadge":false,"displayName":"Example User","followerCount":630338,"followingCount":77,"primaryEthAddress":"0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5"}],"cached":false,"source":"neynar","fetchedAt":"2026-08-22T13:19:12.000Z","rateLimit":{"limit":300,"resetAt":"2026-08-22T13:20:00.000Z","remaining":299},"nextCursor":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JqAGveSXbmrbXd87YZRDO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Farcaster users by name or username fragment, returning profile details including FID, bio, follower counts, and primary Ethereum address","exampleAgentPrompt":"Search Farcaster for users matching 'vitalik', return up to 5 results with their FID, follower count, and Ethereum address.","exampleUseCases":[{"title":"Identify a Farcaster influencer profile","prompt":"Find the Farcaster profile for 'dwr' — I need their FID, follower count, bio, and linked Ethereum wallet address."},{"title":"Resolve on-chain identity from social handle","prompt":"Search Farcaster for someone with the username 'jessepollak' and give me their primary Ethereum address so I can send them a tip."},{"title":"Discover top matching Farcaster accounts","prompt":"I'm looking for Farcaster accounts related to 'base' — search for that name fragment and show me up to 10 results with their scores and power badge status."}],"resultDescription":"Returns a list of matching Farcaster user profiles (up to the requested limit), each containing FID, username, display name, bio, profile picture URL, Warpcast profile URL, follower count, following count, primary Ethereum address, power badge status, and a relevance score. Also includes pagination cursor for fetching more results, total count, cache status, data source, fetch timestamp, and rate limit details.","failureModes":["Empty query or query exceeding 100 characters returns validation error","Limit outside 1–10 range returns validation error","Invalid or expired pagination cursor returns error or empty result","No matching users found returns empty users array with count 0","Rate limit exceeded returns 429 with resetAt timestamp","Upstream Neynar API unavailability causes 5xx error"],"whenToPreferThis":"Use this endpoint when you need to find Farcaster user profiles by name or username fragment, especially when you also need the user's linked Ethereum address or FID for downstream on-chain operations. Prefer this over generic social search when working within the Farcaster/web3 ecosystem, and when you want pay-per-call access without API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:02:08.868Z","isFirstParty":false}