{"uid":"cap_HpIdcneLfj36LYEBEJNmZ","slug":"agent402-farcaster-cast-search-585d32d7","name":"Agent402 Farcaster Cast Search","description":"Search Farcaster casts by keyword (literal, semantic or hybrid match), newest first, optionally filtered to one author or channel. Returns compact casts: hash, author (fid, username, follower count), text, timestamp, channel, reactions, reply count, embed URLs. Use for mention monitoring, sentiment sampling, or finding discussion of a token, product or topic.","url":"https://agent402.tools/api/fc-cast-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"Search text (1-256 chars)."},"mode":{"enum":["literal","semantic","hybrid"],"type":"string","description":"Match mode (default literal)."},"sort":{"enum":["desc_chron","chron"],"type":"string","description":"Newest first (default) or oldest first."},"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 (e.g. base)."},"authorFid":{"type":"integer","description":"Only casts by this fid."}}},"responseSchema":{"type":"json","example":{"mode":"literal","sort":"desc_chron","casts":[{"url":"https://warpcast.com/askew-ai/0xab5aca84","hash":"0xab5aca846db8af6fa3dc2d25dc66171cd040def4","text":"Paid an x402 endpoint for the first time today.","author":{"fid":3117427,"username":"askew-ai","displayName":"askew-ai","followerCount":12},"embeds":["https://example.com/post"],"channel":"ai-agents","replies":2,"reactions":{"likes":4,"recasts":1},"timestamp":"2026-08-22T12:49:27.000Z","parentHash":null}],"count":1,"query":"x402","cached":false,"source":"neynar","channel":null,"authorFid":null,"fetchedAt":"2026-08-22T13:19:12.000Z","rateLimit":{"limit":300,"resetAt":"2026-08-22T13:20:00.000Z","remaining":299},"nextCursor":"eyJ0aW1lc3RhbXAiOi..."}},"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_vfXXHIiKyR2ay_xQfD3dG","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":"Search Farcaster casts (posts) by keyword, semantic meaning, or hybrid mode with optional filters for channel and author","exampleAgentPrompt":"Search Farcaster for the most recent casts mentioning 'x402' using hybrid mode, limit to 10 results, and only show posts from the 'ai-agents' channel.","exampleUseCases":[{"title":"Monitor Farcaster buzz around a token","prompt":"Search Farcaster for recent casts talking about 'BASE chain' in hybrid mode, newest first, limit 25, so I can see what the community is saying right now."},{"title":"Track a specific user's public posts","prompt":"Find the last 50 casts posted by the Farcaster user with FID 3117427, sorted newest first, so I can review their recent activity."},{"title":"Research sentiment in a Farcaster channel","prompt":"Search for casts in the 'defi' channel mentioning 'stablecoin yield' using semantic mode, give me 20 results, newest first."}],"resultDescription":"Returns a JSON object containing an array of matching casts, each with its URL, hash, full text, author details (FID, username, display name, follower count), embeds, channel, reply/reaction counts, and timestamp. Also includes total count, query metadata, source attribution, cache status, rate limit info, and an opaque nextCursor for pagination.","failureModes":["Query text exceeds 256 characters — request rejected","Invalid mode or sort enum value — request rejected","Limit outside 1-100 range — request rejected","Invalid or expired pagination cursor — empty or error response","No matching casts found — returns empty casts array with count 0","Rate limit exceeded — 402 or rate-limit error with resetAt timestamp","Network timeout to upstream Neynar API — 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to search or monitor Farcaster (Warpcast) social content by keyword, semantic concept, or hybrid matching, especially when you want to filter by channel or specific author FID. Prefer this over general web search when the target audience is the Farcaster/web3 social graph. The semantic and hybrid modes make it suitable for concept-level discovery, not just exact keyword matching. Pay-per-call with no API key required makes it ideal for sporadic or agent-driven use cases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:52:29.917Z","isFirstParty":false}