{"uid":"cap_r6Nv-8Y5J370hr3zoIKj_","slug":"api-web3identity-com-a63e2d10","name":"Farcaster User Profile Lookup by FID, Username, or Address","description":"Get Farcaster user profile by FID, username, or connected address","url":"https://api.web3identity.com/api/farcaster/barmstrong","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"fid":{"type":"number"},"username":{"type":"string"},"followers":{"type":"number"},"displayName":{"type":"string"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"bio":"ENS: barmstrong.eth","fid":20,"avatar":"https://i.imgur.com/4t3zVHj.jpg","source":"warpcast","username":"barmstrong","verified":false,"followers":79596,"following":50,"timestamp":"2026-06-12T01:59:11.555Z","displayName":"Brian Armstrong"}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9ItKvREJmKo4cCSZUxx0c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","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 (FID, username, display name, followers) given their FID, username, or connected wallet address","exampleAgentPrompt":"Can you look up the Farcaster profile for the username 'barmstrong' and tell me their FID, display name, and follower count?","exampleUseCases":[{"title":"Verify influencer follower count","prompt":"I'm considering a partnership with a Farcaster creator who goes by 'vitalik.eth' — can you pull up their Farcaster profile and let me know their display name, FID, and how many followers they have?"},{"title":"Resolve wallet to Farcaster identity","prompt":"I have this Ethereum wallet address 0x8fc5d6afe572fefc4ec153be68a46648b5dbda2e — can you find out if it's linked to a Farcaster account and give me the username, FID, and follower count?"},{"title":"Compare two Farcaster user profiles","prompt":"Can you look up the Farcaster profiles for both 'dwr' and 'balajis' and compare their follower counts and display names side by side?"}],"resultDescription":"Returns a JSON object containing the user's Farcaster ID (FID), username, display name, and follower count for the matched profile.","failureModes":["Username or FID not found — returns 404 or empty result","Invalid address format — query fails validation","Payment required (402) if x402 payment not included","Rate limiting if too many requests are made","Farcaster network downtime causing upstream failure"],"whenToPreferThis":"Use this endpoint when you need to resolve a Farcaster identity — by username, FID, or connected wallet address — and retrieve social profile metadata like follower count and display name. Prefer this over generic ENS or on-chain lookups when the target identity is specifically on the Farcaster social protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:37.237Z","isFirstParty":false}