{"uid":"cap_HW2cxPeut58hiYgRUhCro","slug":"neynar-farcaster-user-lookup-by-username-a29944e3","name":"Neynar Farcaster User Lookup by Username","description":"Complete Farcaster developer platform","url":"https://api.neynar.com/v2/farcaster/user/by_username","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"username":"dwr"},"response":{"user":{"fid":3,"pro":{"status":"unsubscribed","expires_at":"2026-06-16T17:21:25.000Z","subscribed_at":"2025-06-16T17:21:25.000Z"},"url":"https://danromero.org","score":0.98,"object":"user","pfp_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original","profile":{"bio":{"text":"Interested in technology and other stuff."},"banner":{"url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/dab99f37-561b-4bd2-6d73-86f828a76d00/original"}},"username":"dwr","display_name":"Dan Romero","experimental":{"neynar_user_score":0.98,"deprecation_notice":"The `neynar_user_score` field under `experimental` will be deprecated after June 1, 2025, as it will be formally promoted to a stable field named `score` within the user object."},"registered_at":"2023-11-07T19:42:51.000Z","verifications":["0xd7029bdea1c17493893aafe29aad69ef892b8ff2","0x187c7b0393ebe86378128f2653d0930e33218899","0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5"],"auth_addresses":[{"app":{"fid":9152,"object":"user_dehydrated"},"address":"0x187c7b0393ebe86378128f2653d0930e33218899"}],"follower_count":630265,"custody_address":"0x6b0bda3f2ffed5efc83fa8c024acff1dd45793f1","following_count":77,"verified_accounts":[{"platform":"x","username":"dwr"}],"verified_addresses":{"primary":{"eth_address":"0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5","sol_address":"ExAqci8uUVKtqHqFW58fmwgMMY9PATfRGGyv6837j9Lx"},"eth_addresses":["0xd7029bdea1c17493893aafe29aad69ef892b8ff2","0x187c7b0393ebe86378128f2653d0930e33218899","0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5"],"sol_addresses":["ExAqci8uUVKtqHqFW58fmwgMMY9PATfRGGyv6837j9Lx"]}}}},"exampleRequest":{"username":"dwr"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sEhAFJ5Z-lk-_lZ0PjL6-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a Farcaster user's profile and account details by their username","exampleAgentPrompt":"Can you look up the Farcaster profile for the username 'dwr' — I need their FID, bio, follower count, and any verified Ethereum addresses linked to their account?","exampleUseCases":null,"resultDescription":"Returns a Farcaster user object containing the user's FID, username, display name, profile bio, follower and following counts, profile picture URL, custody address, and verified Ethereum wallet addresses.","failureModes":["Username not found — returns 404 with error message","Invalid or missing username parameter — returns 400 bad request","Payment not provided or insufficient — returns 402 payment required","Rate limit exceeded — returns 429 too many requests","Farcaster network unavailable — returns 503 service unavailable"],"whenToPreferThis":"Use this endpoint when you need to resolve a Farcaster handle to a full user profile, FID, or linked wallet addresses. Prefer this over searching by FID when you have a human-readable username as the starting point. Ideal for onboarding flows, social graph enrichment, or cross-referencing Farcaster identities with Ethereum addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:04.760Z","isFirstParty":false}