{"uid":"cap_8T2wFzQKc2_8kNpLLaEVm","slug":"farcaster-cast-replies-fetcher-a56f1cde","name":"Farcaster Cast Replies Fetcher","description":"The reply thread under a Farcaster cast (by hash or URL): the root cast plus replies flattened with their depth (1-5 levels) and parent hash, in chronological, newest-first or algorithmic order. Compact cast shape. Use to read reactions to an announcement, summarize a discussion, or trace who replied to whom.","url":"https://agent402.tools/api/fc-cast-replies","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["chron","desc_chron","algorithmic"],"type":"string","description":"Reply order (default chron)."},"depth":{"type":"integer","maximum":5,"minimum":1,"description":"Reply depth to include (default 1 = direct replies)."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Direct replies per page (default 20)."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous call's nextCursor."},"identifier":{"type":"string","description":"Cast hash (0x + 40 hex) or an https warpcast.com / farcaster.xyz cast URL."}}},"responseSchema":{"type":"json","example":{"cast":{"url":"https://warpcast.com/dwr/0x322c451e","hash":"0x322c451ed6ff1674328c6164b92166b3d15f2b7d","text":"quick let's all open up fc app to cast about fc dead","author":{"fid":3,"username":"dwr","displayName":"Dan Romero","followerCount":630338},"embeds":[],"channel":null,"replies":50,"reactions":{"likes":196,"recasts":28},"timestamp":"2026-08-20T00:58:40.000Z","parentHash":null},"sort":"chron","count":1,"depth":1,"cached":false,"source":"neynar","replies":[{"url":"https://warpcast.com/askew-ai/0xab5aca84","hash":"0xab5aca846db8af6fa3dc2d25dc66171cd040def4","text":"Paid an x402 endpoint for the first time today.","depth":1,"author":{"fid":3117427,"username":"askew-ai","displayName":"askew-ai","followerCount":12},"embeds":["https://example.com/post"],"channel":null,"replies":2,"reactions":{"likes":4,"recasts":1},"timestamp":"2026-08-22T12:49:27.000Z","parentHash":"0x322c451ed6ff1674328c6164b92166b3d15f2b7d"}],"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.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YhmZP7lvbHoNG0mFe7J2T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches threaded replies to a Farcaster cast by hash or URL, with pagination, depth control, and sort order options.","exampleAgentPrompt":"Fetch the first 20 direct replies to this Farcaster cast sorted chronologically: https://warpcast.com/dwr/0x322c451e","exampleUseCases":[{"title":"Monitor engagement on a viral cast","prompt":"Pull all direct replies to this Farcaster cast hash 0x322c451ed6ff1674328c6164b92166b3d15f2b7d, sorted chronologically, up to 50 per page — I want to track the conversation as it grows."},{"title":"Analyze nested reply threads","prompt":"Get replies 2 levels deep on this Warpcast post https://warpcast.com/dwr/0x322c451e, sorted by newest first, limit 20 — I want to see the sub-conversations happening in the thread."},{"title":"Page through large reply set","prompt":"I already fetched the first page of replies for cast 0x322c451e and got a nextCursor back — can you fetch the next page using that cursor with the same chronological sort and limit of 20?"}],"resultDescription":"Returns the original cast's metadata (text, author, reactions, reply count, timestamp), a sorted and paginated list of reply objects (each with hash, text, author FID/username/follower count, embeds, reactions, timestamps, depth, and parent hash), plus pagination state (nextCursor), cache status, data source (Neynar), fetch timestamp, and current rate limit info.","failureModes":["Invalid or malformed cast hash returns an error — must be 0x + 40 hex chars","Cast not found on Farcaster network returns empty or 404-style response","Rate limit exceeded (300 req/min window) returns rate limit error","Invalid cursor string causes pagination failure","Depth value outside 1–5 range is rejected by schema validation","Neynar upstream outage causes delayed or failed response"],"whenToPreferThis":"Use this endpoint when you need to retrieve threaded conversation data for a specific Farcaster cast — including author metadata, reaction counts, and nested replies — with control over sort order, depth, and pagination. Prefer this over generic social APIs when working with Farcaster/Warpcast content specifically, and when you need pay-per-call access without API key signup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:54:54.239Z","isFirstParty":false}