{"uid":"cap_EU4F9RWuhd7WLcbSuHyWb","slug":"agent402-farcaster-cast-lookup-3ec23663","name":"Agent402 Farcaster Cast Lookup","description":"Fetch one Farcaster cast by hash or warpcast.com / farcaster.xyz URL. Returns the compact cast: author (fid, username, follower count), text, timestamp, channel, parent hash, likes, recasts, reply count, embed URLs. Use to resolve a shared link, verify a quote, or enrich a cast hash from another tool.","url":"https://agent402.tools/api/fc-cast","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"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},"cached":false,"source":"neynar","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_8MgUOYLyMMPA5kDWIBm1B","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":"Fetch full metadata for a Farcaster cast by hash or Warpcast URL, including author, engagement stats, embeds, and channel.","exampleAgentPrompt":"Can you pull up the details for this Farcaster cast — https://warpcast.com/dwr/0x322c451e — I want to know the text, how many likes it got, and who posted it.","exampleUseCases":[{"title":"Monitoring influencer cast engagement","prompt":"Fetch the cast at 0x322c451ed6ff1674328c6164b92166b3d15f2b7d on Farcaster and tell me how many likes, recasts, and replies it has so I can see how it's performing."},{"title":"Verifying cast content before sharing","prompt":"I got sent this Warpcast link — https://warpcast.com/dwr/0x322c451e — can you retrieve the actual text of the cast and confirm who posted it and when?"},{"title":"Aggregating cast stats for a report","prompt":"Look up this Farcaster cast by hash 0x322c451ed6ff1674328c6164b92166b3d15f2b7d and give me the author's username, follower count, and all engagement numbers so I can include them in my weekly social report."}],"resultDescription":"Returns a JSON object containing the cast's full text, URL, hash, author details (FID, username, display name, follower count), embed list, channel, reply/like/recast counts, timestamp, parent hash, and whether the result was served from cache. Also includes rate limit info and the upstream data source (Neynar).","failureModes":["Invalid or malformed cast hash returns an error — hash must be 0x followed by 40 hex characters","Cast not found on Farcaster returns a null or error response","Rate limit exhausted — the rateLimit.remaining field will show 0 and resetAt indicates when quota refreshes","Malformed Warpcast URL that doesn't resolve to a valid cast will fail to fetch","Upstream Neynar API outage may cause fetch failures or delayed responses"],"whenToPreferThis":"Choose this endpoint when you need to retrieve structured metadata for a specific Farcaster cast by its hash or Warpcast/Farcaster URL, without needing a Neynar API key or any signup — payment is per-call via USDC over x402. Prefer this over direct Neynar API calls when operating as an autonomous agent with a wallet identity, or when you need a frictionless, keyless lookup for one-off or low-volume cast resolution tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:59:25.014Z","isFirstParty":false}