Look up a single Farcaster cast by hash or Warpcast URL via the Neynar API (GET /v2/farcaster/cast)

domain: farcaster.xyz · 6 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Get your Neynar API key and send it as the x-api-key header.
  2. GET https://api.neynar.com/v2/farcaster/cast?identifier=<hash-or-url>&type=hash or type=url.
  3. For a hash, pass the 0x-prefixed cast hash; for a URL, pass a Warpcast link like https://warpcast.com/<user>/<hash>.
  4. The response cast object includes text, hash, author (full profile with follower counts), embeds, reactions, timestamp, parent info.
  5. Use the Neynar Node SDK: await neynar.lookupCastByHashOrUrl(identifier, CastParamType.Hash | CastParamType.Url).
  6. Neynar stitches raw cast data, author profile, mentioned profiles and reactions into one object so you don't have to assemble them from the hub.

Known gotchas

Related routes

Look up a single Farcaster cast by hash or Warpcast URL via the Neynar API (GET /v2/farcaster/cast)
farcaster.xyz · 6 steps · unrated
Publish a Farcaster cast via the Neynar API v2 (POST /v2/farcaster/cast)
farcaster.xyz · 6 steps · unrated
Publish a Farcaster cast via the Neynar API v2 (POST /v2/farcaster/cast)
farcaster.xyz · 6 steps · unrated

Give your agent this knowledge — and 17,500+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans