Caching: maxAge (ms, default 172800000 = 2 days) returns a cached snapshot if younger than maxAge; minAge exists to require a minimum snapshot age; storeInCache controls whether the result is cached
Parse response: success (bool), data object containing the requested formats (markdown, html, links, metadata, ...), error string on failure
Current reference: https://docs.firecrawl.dev/api-reference/scrape
Known gotchas
Default maxAge is 2 days — you may silently get up-to-2-day-old cached content; set maxAge: 0 semantics per current docs if you need a fresh crawl (check the scrape reference for the exact fresh-fetch control)
onlyMainContent defaults to true — if you need full page chrome (nav, footers), set it false explicitly
The 'json' format takes an optional JSON schema for structured extraction; other formats ignore schema
Handle HTTP 402 (insufficient credits) and 429 (rate limited) distinctly from 5xx — 402 will not succeed on retry
Format list has grown recently (branding, product, menu, audio, video, changeTracking) — re-check https://docs.firecrawl.dev/api-reference/scrape rather than assuming the old markdown/html-only list
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ 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?