{"uid":"cap_rtnn2seu2xRW8RiFqsNdP","slug":"api-web3identity-com-f0e9cb3d","name":"Farcaster User Profile Lookup","description":"Get Farcaster user profile by FID, username, or connected address","url":"https://api.web3identity.com/api/farcaster/linda","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":"taking a break to self study physics. previously: dev eco @farcaster, cofounder \n@bountycaster and scalar capital, early @coinbase, coproducer @ethereumfilm","fid":12,"avatar":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/6aa18817-6238-4b25-086f-1edd0c438f00/original","source":"warpcast","username":"linda","verified":false,"followers":251321,"following":1341,"timestamp":"2026-05-29T18:37:29.732Z","displayName":"Linda Xie"}},"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_im8yq4x5WY0nwsluimYNi","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 including FID, username, display name, and follower count by FID, username, or connected wallet address","exampleAgentPrompt":"Can you pull up the Farcaster profile for the user 'linda' — I want to see her FID, display name, and how many followers she has?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the user's Farcaster ID (FID), username, display name, and follower count for the queried user.","failureModes":["Username or FID not found — returns 404 or empty result","Invalid or unrecognized wallet address — no profile match","Payment not included or rejected — 402 payment required error","Rate limiting or server error — 5xx response","Malformed query parameter — 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to resolve a Farcaster identity — username, FID, or connected wallet address — into a structured user profile with social stats. Prefer this over scraping Farcaster directly or using on-chain lookups when you need a fast, aggregated profile response including follower counts and display names.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:46:00.542Z","isFirstParty":false}