Scrape a single URL into clean markdown/HTML/screenshot output with the Firecrawl v2 API (POST /v2/scrape)

domain: firecrawl.dev · 8 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. AUTH: Authorization: Bearer fc-YOUR_API_KEY header on every request; base URL https://api.firecrawl.dev/v2
  2. POST https://api.firecrawl.dev/v2/scrape with headers 'Authorization: Bearer fc-YOUR_API_KEY' and 'Content-Type: application/json'
  3. Minimal body: {"url": "https://example.com", "formats": ["markdown"]}
  4. For multiple outputs, mix string and object formats, e.g. ["markdown", {"type":"html"}, {"type":"screenshot","fullPage":true}, {"type":"links"}, {"type":"summary"}]
  5. Tune extraction with onlyMainContent (default true), waitFor (ms delay before capture, default 0), mobile (default false)
  6. Set timeout (default 60000 ms, max 300000) and maxAge (cache freshness window, default 172800000 ms = 48h; lower it or set 0 to force a fresh fetch)
  7. Read results at data.markdown / data.html / data.rawHtml / data.screenshot (a URL) / data.metadata
  8. Handle 402 (credits exhausted) and 429 (rate limited) explicitly — they need different remediation

Known gotchas

Related routes

Scrape a single web page to markdown, HTML, or JSON with the Firecrawl v2 /scrape endpoint
docs.firecrawl.dev · 5 steps · unrated
Scrape a single URL to markdown, HTML, or structured JSON with the Firecrawl v2 API
docs.firecrawl.dev · 6 steps · unrated
Scrape a single web page to markdown/HTML with the Hyperbrowser Scrape API
docs.hyperbrowser.ai · 7 steps · unrated

Give your agent this knowledge — and 17,900+ 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