{"uid":"cap_O07T7BVZHskxwvtMm24_p","slug":"agent402-farcaster-user-casts-fetcher-679aa982","name":"Agent402 Farcaster User Casts Fetcher","description":"A Farcaster user's recent casts by fid or username, newest first, optionally including replies or limited to one channel. Compact cast shape with reactions, reply count and embed URLs. Use to read what a founder, builder or KOL has been posting, or to build a per-account timeline.","url":"https://agent402.tools/api/fc-user-casts","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"fid":{"type":"integer","description":"Farcaster ID (one of fid/username required)."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page (default 25)."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous call's nextCursor."},"channel":{"type":"string","description":"Only casts in this channel id."},"username":{"type":"string","description":"Farcaster username, optional leading @ (one of fid/username required; costs one extra upstream lookup)."},"includeReplies":{"type":"boolean","description":"Include the user's replies (default false)."}}},"responseSchema":{"type":"json","example":{"fid":3,"casts":[{"url":"https://warpcast.com/askew-ai/0xab5aca84","hash":"0xab5aca846db8af6fa3dc2d25dc66171cd040def4","text":"Paid an x402 endpoint for the first time today.","author":{"fid":3,"username":"dwr","displayName":"Dan Romero","followerCount":630338},"embeds":["https://example.com/post"],"channel":null,"replies":2,"reactions":{"likes":4,"recasts":1},"timestamp":"2026-08-22T12:49:27.000Z","parentHash":null}],"count":1,"cached":false,"source":"neynar","channel":null,"fetchedAt":"2026-08-22T13:19:12.000Z","rateLimit":{"limit":300,"resetAt":"2026-08-22T13:20:00.000Z","remaining":299},"nextCursor":"eyJ0aW1lc3RhbXAiOi...","includeReplies":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kSXchznl90RdNUVg3mq8a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent casts (posts) by a Farcaster user, optionally filtered by channel or including replies, returning paginated cast metadata.","exampleAgentPrompt":"Can you pull the last 50 casts from Farcaster user @dwr, including only posts in the 'ethereum' channel and no replies?","exampleUseCases":[{"title":"Monitor influencer activity on Farcaster","prompt":"Show me the last 25 casts from Farcaster user @vitalik so I can see what he's been talking about recently."},{"title":"Track brand channel posts","prompt":"Fetch up to 100 casts that @jessepollak has made in the 'base' channel on Farcaster — skip replies, just original posts."},{"title":"Paginate through a user's full cast history","prompt":"I already pulled the first page of casts for Farcaster FID 3 — here's the cursor: 'eyJ0aW1lc3RhbXAiOi...' — can you get the next 25 casts including their replies?"}],"resultDescription":"A JSON object containing an array of cast objects (each with hash, URL, text, author details, engagement counts, embeds, channel, and timestamp), total count, pagination cursor for the next page, cache status, data source, fetch timestamp, and current rate limit state.","failureModes":["Missing both fid and username returns a validation error","Invalid or unknown fid/username returns empty casts array or upstream error","Invalid cursor string causes pagination failure","Upstream Neynar rate limit exceeded returns rate limit error","Channel ID not found returns empty results","limit out of range (below 1 or above 100) returns validation error"],"whenToPreferThis":"Choose this endpoint when you need structured, paginated access to a Farcaster user's cast history with engagement metadata, especially when you want to filter by channel or toggle reply inclusion. It is backed by Neynar, making it reliable for production agent workflows. Prefer it over scraping Warpcast directly or building your own Farcaster client.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:01:18.884Z","isFirstParty":false}