{"uid":"cap_3WjxNktqeW1oehOPHFPB9","slug":"agent402-farcaster-channel-lookup-c1b0e165","name":"Agent402 Farcaster Channel Lookup","description":"Details for one Farcaster channel by id (e.g. base) or FIP-2 parent URL: name, description, follower and member counts, public-casting flag, creation date, lead and moderator fids, pinned cast. Use to validate a channel id before pulling its feed, or to size a community.","url":"https://agent402.tools/api/fc-channel","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string","description":"Channel id (e.g. base) or its https parent URL."}}},"responseSchema":{"type":"json","example":{"cached":false,"source":"neynar","channel":{"id":"base","url":"https://warpcast.com/~/channel/base","lead":{"fid":12142,"username":"base.base.eth","displayName":"Base","followerCount":194536},"name":"Base","imageUrl":"https://warpcast.com/~/channel-images/base.png","createdAt":"2023-08-17T19:23:11.150Z","parentUrl":"https://onchainsummer.xyz","description":"Bringing the world onchain - a community of builders on Base","memberCount":813,"followerCount":481202,"moderatorFids":[12142,15211,99],"publicCasting":false,"pinnedCastHash":null},"fetchedAt":"2026-08-22T13:19:12.000Z","rateLimit":{"limit":300,"resetAt":"2026-08-22T13:20:00.000Z","remaining":299}}},"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_cysX4vki_JFtRqisp-9sd","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":"Fetches metadata for a Farcaster channel by its ID or parent URL, including follower count, member count, moderators, and description.","exampleAgentPrompt":"Can you look up the Farcaster channel with ID 'base' and tell me its follower count, member count, lead user, and description?","exampleUseCases":[{"title":"Channel growth tracking for community manager","prompt":"Pull the current follower count and member count for the Farcaster channel 'degen' so I can track how it's growing week over week."},{"title":"Moderator discovery for outreach","prompt":"Who are the moderators of the Farcaster channel 'zora'? I need their FIDs so I can reach out about a partnership."},{"title":"Channel validation before integration","prompt":"I'm building a bot that posts to the 'base' Farcaster channel — can you confirm its parent URL, whether public casting is allowed, and fetch its current metadata?"}],"resultDescription":"Returns a JSON object with the channel's id, name, URL, description, imageUrl, createdAt timestamp, parentUrl, memberCount, followerCount, publicCasting flag, pinnedCastHash, moderatorFids, and lead user details (fid, username, displayName, followerCount). Also includes a fetchedAt timestamp, cache status, source attribution (Neynar), and rate limit info (limit, remaining, resetAt).","failureModes":["Invalid or unknown channel ID returns an error or empty result","Malformed parent URL input may fail to resolve to a channel","Rate limit exceeded: rateLimit.remaining reaches 0 before resetAt","Neynar upstream outage causes lookup failure","Channel ID string typo returns null or not-found response"],"whenToPreferThis":"Use this endpoint when you need structured metadata about a specific Farcaster/Warpcast channel — its follower count, member list size, moderators, or description — and you have the channel ID or its parent URL. It's backed by Neynar, a leading Farcaster indexer, and returns richer per-channel detail than a general social graph search. Prefer it over scraping Warpcast directly or using a generic social API that doesn't understand Farcaster's channel model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:55:38.166Z","isFirstParty":false}