{"uid":"cap_8Jsqb9awOQBIFiWCX2Qcc","slug":"agent402-farcaster-cast-metrics-bfd417eb","name":"Agent402 Farcaster Cast Metrics","description":"Cast volume over time for a search query: how many Farcaster casts matched per bucket across the last 1d, 7d, 30d, 90d or 180d (hourly or daily buckets), optionally limited to one author or channel, plus the total. Cached 60 s. Use to chart mention volume for a token, product or event and detect spikes.","url":"https://agent402.tools/api/fc-cast-metrics","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","description":"Search text (1-256 chars)."},"channel":{"type":"string","description":"Only casts in this channel id."},"interval":{"enum":["1d","7d","30d","90d","180d"],"type":"string","description":"Lookback window (default 7d)."},"authorFid":{"type":"integer","description":"Only casts by this fid."}}},"responseSchema":{"type":"json","example":{"query":"x402","total":42,"cached":false,"source":"neynar","buckets":[{"count":1,"start":"2026-08-15T15:00:00.000Z"},{"count":7,"start":"2026-08-15T16:00:00.000Z"}],"channel":null,"interval":"7d","authorFid":null,"fetchedAt":"2026-08-22T13:19:12.000Z","rateLimit":{"limit":300,"resetAt":"2026-08-22T13:20:00.000Z","remaining":299},"bucketCount":168,"resolutionSeconds":3600}},"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_seE6fcymye5wAPle53AqT","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 by keyword, channel, or author and return time-bucketed engagement counts over a configurable lookback window","exampleAgentPrompt":"How many times has 'x402' been mentioned on Farcaster in the last 30 days, broken down by hour? Search across all channels.","exampleUseCases":[{"title":"Track crypto protocol buzz on Farcaster","prompt":"Search Farcaster for 'Base L2' mentions over the past 7 days and show me how the cast volume trended hour by hour."},{"title":"Monitor a specific channel's activity","prompt":"How active has the /dev channel on Farcaster been over the last 30 days? Give me the total cast count and hourly breakdown."},{"title":"Measure a specific user's posting frequency","prompt":"How many casts has Farcaster user with FID 3 posted in the last 90 days, and what does their daily posting pattern look like?"}],"resultDescription":"Returns a JSON object containing the total number of matching casts, an array of time buckets (each with a start timestamp and count), the query parameters echoed back (query, channel, interval, authorFid), the data source (Neynar), whether the result was cached, the fetch timestamp, bucket resolution in seconds, bucket count, and current rate-limit state (limit, remaining, resetAt).","failureModes":["Query string exceeds 256 characters returns a validation error","Invalid or non-existent channel ID returns empty results or error","Invalid interval enum value returns a 400 bad request","Rate limit exceeded (300 calls/minute) returns a 429 with resetAt timestamp","Neynar upstream outage may cause delayed or failed responses"],"whenToPreferThis":"Choose this endpoint when you need time-series cast volume data from Farcaster — particularly for trend analysis, keyword monitoring, channel activity tracking, or per-author posting frequency. It is backed by Neynar and returns pre-bucketed hourly data, making it ideal for charting and alerting workflows. Prefer this over generic social listening tools when your target platform is specifically Farcaster/Warpcast and you need structured, pageable metrics rather than raw cast content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:45:08.659Z","isFirstParty":false}