Firecrawl v2.9.0

Improvements

Browser Interaction via /interact endpoint — Scrape a page, then call /interact to take actions on it — click buttons, fill forms, navigate deeper, or extract dynamic content. Describe what you want in natural language via prompt, or write Playwright code (Node.js, Python) and Bash (agent-browser) for full control. Sessions persist across calls, with live view and interactive live view URLs for real-time browser streaming. Persistent profiles let you save and reuse browser state (cookies, localStorage) across scrapes. Available in JS, Python, Java, and Rust SDKs.
query format — Added query format to the /scrape endpoint — pass a natural-language prompt and get a direct answer back in data.answer.
audio format — Added audio format option to scrape responses, returning audio output as a field on the document.
onlyCleanContent parameter — Added onlyCleanContent parameter to the /scrape endpoint, which strips navigation, ads, cookie banners, and other non-semantic content from markdown output.
PDF parsing modes — Added PDF parsing modes (fast, auto, ocr) and a maxPages option to control extraction depth and OCR behavior.
Java and Elixir SDKs — Added official Java and Elixir SDKs with full v2 API support.
Legacy .doc file support — Added support for parsing legacy .doc files.
Wikimedia engine — Added a dedicated engine for scraping Wikipedia and Wikimedia pages with improved output quality.
contentType in scrape responses — Added contentType to scrape responses for PDFs and documents.
PDF pipeline improvements — Improved PDF pipeline with better table detection, header/footer stripping, mixed PDF handling, inline image parsing, and magic byte detection.
Branding extraction — Improved branding extraction to skip hidden DOM elements for cleaner output.
HTML-to-markdown performance — Improved HTML-to-markdown conversion performance and fixed code blocks losing content during conversion.
Concurrency queue — New concurrency queue system with reconciler and backfill for more reliable job scheduling.
Rust SDK v2 — Added v2 API namespace with agent support to the Rust SDK.
Fixed Python SDK parameters timeout, max_retries, and backoff_factor — these were previously accepted but silently ignored.
Capped job timeouts at 48 hours to prevent runaway jobs from consuming resources.
Added retry limits to prevent scrape loops.
Binary content types are now rejected early in the scrape pipeline to avoid wasted processing.

Fixes

Fixed empty responses when using the o3-mini model on extract jobs.
Fixed revoked API keys remaining valid for up to 10 minutes after deletion.
Fixed a race condition in extract jobs that caused "Job not found" crashes.
Fixed time_taken in /v1/map always returning ~0.
Fixed crawl status responses now surfacing a failed status with an error message and partial data when a crawl-level failure occurs.
Fixed maxPages not being passed to the PDF extractor — previously, full PDF content was returned while only charging for the limited page count.
Fixed free request credits being incorrectly consumed and billed on agent jobs exceeding the maxCredits threshold.
Fixed dashboard displaying incorrect concurrency limits due to stale reads.
Fixed branding colors.secondary not being populated.
Fixed removeBase64Images running after deriveDiff in the transformer pipeline, causing diff issues.
Fixed GCS fetch using wrong row index for cache info lookups.
Fixed unhandled ZodError in /v1/search controller.
Resolved multiple CVEs across dependencies including handlebars, path-to-regexp, fast-xml-parser, rollup (CVE-2026-27606), undici, and others.
Hardened the Playwright service against SSRF attacks.

API

Added GET /v2/team/activity endpoint for listing recent scrape, crawl, and extract jobs with cursor-based pagination (last 24 hours, up to 100 results per page, filterable by endpoint type).
Added regexOnFullURL parameter on crawl requests to apply includePaths/excludePaths filtering against the full URL including query parameters. Available in JS, Python, Java, and Elixir SDKs.
Added deduplicateSimilarURLs parameter on crawl requests. Available in JS, Python, Java, and Elixir SDKs.
Deprecated the extract endpoint — use the /agent endpoint instead. Existing extract methods in JS and Python SDKs are marked deprecated.
Renamed persistentSession to profile on browser/interact requests (writeMode is now saveChanges). The old parameter name remains functional but is no longer documented.

New Contributors

@misza-one made their first contribution in https://github.com/firecrawl/firecrawl/pull/2660
@madmikeross made their first contribution in https://github.com/firecrawl/firecrawl/pull/2948
@rowinsg made their first contribution in https://github.com/firecrawl/firecrawl/pull/3065
@Bortlesboat made their first contribution in https://github.com/firecrawl/firecrawl/pull/3243
@dagecko made their first contribution in https://github.com/firecrawl/firecrawl/pull/3249
@cokemine made their first contribution in https://github.com/firecrawl/firecrawl/pull/3262
@paulonasc made their first contribution in https://github.com/firecrawl/firecrawl/pull/3275

Contributors

@nickscamara
@mogery
@amplitudesxd
@abimaelmartell
@ericciarla
@rafaelsideguide
@delong3
@devhims
@Chadha93
@tomsideguide
@charlietlamb
@developersdigest
@micahstairs
@rhys-firecrawl
@firecrawl-spring
@devin-ai-integration
@misza-one
@madmikeross
@rowinsg
@Bortlesboat
@dagecko
@cokemine
@paulonasc

Full Changelog: https://github.com/firecrawl/firecrawl/compare/v2.8.0...v2.9.0