From 6065209469f35982be909a21ba5d55744f410afa Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Wed, 19 Aug 2026 08:51:47 +0000 Subject: [PATCH 1/2] docs(proxies): proxy parameter now always runs auto MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit basic, stealth, and enhanced are still accepted but no longer change behavior — every request runs in auto mode (starts basic, escalates to enhanced on failure). Updates the v1 and v2 proxy/enhanced-mode pages. Co-Authored-By: micahstairs --- features/enhanced-mode.mdx | 18 +++++++++--------- features/proxies.mdx | 10 +++------- v1/features/proxies.mdx | 10 +++------- v1/features/stealth-mode.mdx | 15 +++++++-------- 4 files changed, 22 insertions(+), 31 deletions(-) diff --git a/features/enhanced-mode.mdx b/features/enhanced-mode.mdx index 4749f827..04fe4912 100644 --- a/features/enhanced-mode.mdx +++ b/features/enhanced-mode.mdx @@ -9,25 +9,25 @@ import ProxyPython from "/snippets/v2/scrape/proxy/python.mdx"; import ProxyNode from "/snippets/v2/scrape/proxy/js.mdx"; import ProxyCURL from "/snippets/v2/scrape/proxy/curl.mdx"; - -The `proxy` parameter is deprecated. We recommend `auto` — the default — which lets Firecrawl handle proxy selection for you. - + +The `proxy` parameter no longer changes behavior. Every request runs in `auto` mode, so Firecrawl handles enhanced escalation for you automatically. + -Firecrawl provides different proxy types to help you scrape websites with varying levels of complexity. Set the `proxy` parameter to control which proxy strategy is used for a request. +Firecrawl automatically uses enhanced proxies when a site needs them. Every request runs in `auto` mode: Firecrawl starts on a basic proxy and retries with enhanced proxies only if the basic proxy fails. ## Proxy types | Type | Description | |------|-------------| -| `basic` | Standard proxies suitable for most sites | -| `enhanced` | Enhanced proxies for complex sites | -| `auto` | **Recommended.** Tries `basic` first, then retries with `enhanced` on failure | +| `auto` | The behavior for every request. Starts on `basic`, then retries with `enhanced` on failure. | +| `basic` | Accepted for backward compatibility. Behaves identically to `auto`. | +| `enhanced` | Accepted for backward compatibility. Behaves identically to `auto`. | -If you do not specify a proxy, Firecrawl defaults to `auto`. +The `proxy` parameter is optional and no longer needs to be set — all values resolve to `auto`. ## Basic usage -Set the `proxy` parameter to choose a proxy strategy. The following example uses `auto`, which lets Firecrawl decide when to escalate to enhanced proxies. +The `proxy` parameter is optional. Whether or not you set it, Firecrawl runs in `auto` mode and decides when to escalate to enhanced proxies. diff --git a/features/proxies.mdx b/features/proxies.mdx index d7a24d43..07772e35 100644 --- a/features/proxies.mdx +++ b/features/proxies.mdx @@ -44,12 +44,8 @@ For full details, see the [API reference for `location.country`](https://docs.fi ## Proxy Types - -The `proxy` parameter is deprecated. We recommend `auto` — the default — which lets Firecrawl handle proxy selection for you. - - -- **basic**: Proxies for scraping most sites. -- **enhanced**: Enhanced proxies for scraping complex sites while maintaining privacy. [Learn more about Enhanced Mode →](/features/enhanced-mode) -- **auto**: Recommended. Firecrawl will automatically retry scraping with enhanced proxies if the basic proxy fails. + +The `proxy` parameter no longer changes behavior. Every request now runs in **`auto`** mode: Firecrawl starts on a basic proxy and automatically escalates to enhanced proxies only if the basic proxy fails. The `basic`, `enhanced`, and `auto` values are still accepted for backward compatibility, but all behave identically — there is no way to force basic-only or enhanced-only, and enhanced retries carry no extra charge. [Learn more about Enhanced Mode →](/features/enhanced-mode) + > Are you an AI agent that needs a Firecrawl API key? See [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for automated onboarding instructions. diff --git a/v1/features/proxies.mdx b/v1/features/proxies.mdx index afa3d5d0..cfc3e9cc 100644 --- a/v1/features/proxies.mdx +++ b/v1/features/proxies.mdx @@ -42,10 +42,6 @@ For full details, see the [API reference for `location.country`](https://docs.fi ## Proxy Types - -The `proxy` parameter is deprecated. We recommend `auto`, which lets Firecrawl handle proxy selection for you. - - -- **basic**: Proxies for scraping most sites. -- **enhanced**: Enhanced proxies for scraping complex sites while maintaining privacy. [Learn more about Enhanced Mode →](/features/enhanced-mode) -- **auto**: Recommended. Firecrawl will automatically retry scraping with enhanced proxies if the basic proxy fails. + +The `proxy` parameter no longer changes behavior. Every request now runs in **`auto`** mode: Firecrawl starts on a basic proxy and automatically escalates to enhanced proxies only if the basic proxy fails. The `basic`, `enhanced`, and `auto` values are still accepted for backward compatibility, but all behave identically, and enhanced retries carry no extra charge. [Learn more about Enhanced Mode →](/features/enhanced-mode) + diff --git a/v1/features/stealth-mode.mdx b/v1/features/stealth-mode.mdx index 89da72d2..e5797704 100644 --- a/v1/features/stealth-mode.mdx +++ b/v1/features/stealth-mode.mdx @@ -9,19 +9,18 @@ import ProxyPython from "/snippets/v1/scrape/proxy/python.mdx"; import ProxyNode from "/snippets/v1/scrape/proxy/js.mdx"; import ProxyCURL from "/snippets/v1/scrape/proxy/curl.mdx"; - -The `proxy` parameter is deprecated. We recommend `auto`, which lets Firecrawl handle proxy selection for you. - + +The `proxy` parameter no longer changes behavior. Every request runs in `auto` mode, so Firecrawl handles enhanced escalation for you automatically. + -Firecrawl provides different proxy types to help you scrape websites with varying levels of complexity. The proxy type can be specified using the `proxy` parameter. +Firecrawl automatically uses enhanced proxies when a site needs them. Every request runs in `auto` mode, regardless of the `proxy` value you send. ### Proxy Types -- **basic**: Proxies for scraping most sites. -- **enhanced**: Enhanced proxies for scraping complex sites while maintaining privacy. -- **auto**: Recommended. Firecrawl will automatically retry scraping with enhanced proxies if the basic proxy fails. +- **auto**: The behavior for every request. Firecrawl starts on a basic proxy and automatically retries with enhanced proxies if it fails. +- **basic** / **enhanced**: Accepted for backward compatibility, but both behave identically to `auto`. -If you do not specify a proxy, Firecrawl will default to basic. +The `proxy` parameter is optional and no longer needs to be set — all values resolve to `auto`. ### Using Enhanced Mode From e32c00214b24c1dfa993e00449a0cc6754032623 Mon Sep 17 00:00:00 2001 From: "firecrawl-spring[bot]" <254786068+firecrawl-spring[bot]@users.noreply.github.com> Date: Wed, 19 Aug 2026 09:01:53 +0000 Subject: [PATCH 2/2] docs(proxies): retire enhanced mode page, consolidate proxy docs Hide/retire the enhanced-mode page (and the v1 stealth-mode page), redirect their URLs to /features/proxies, and remove the Enhanced Mode sections from the scrape pages. Proxy behavior is now described only on /features/proxies, with cleaner copy that doesn't brand it as a mode. Co-Authored-By: micahstairs --- docs.json | 8 ++++--- features/enhanced-mode.mdx | 46 ------------------------------------ features/proxies.mdx | 8 +++---- features/scrape.mdx | 6 ----- v1/features/proxies.mdx | 8 +++---- v1/features/scrape.mdx | 6 ----- v1/features/stealth-mode.mdx | 37 ----------------------------- 7 files changed, 13 insertions(+), 106 deletions(-) delete mode 100644 features/enhanced-mode.mdx delete mode 100644 v1/features/stealth-mode.mdx diff --git a/docs.json b/docs.json index c75eecbf..34414357 100755 --- a/docs.json +++ b/docs.json @@ -175,7 +175,6 @@ "features/batch-scrape", "features/llm-extract", "features/change-tracking", - "features/enhanced-mode", "features/lockdown", "features/pii-redaction", "features/proxies", @@ -743,7 +742,6 @@ "features/batch-scrape", "features/llm-extract", "features/change-tracking", - "features/enhanced-mode", "features/proxies" ] }, @@ -4934,9 +4932,13 @@ "source": "/api-reference/v2-endpoint/:slug*" }, { - "destination": "/features/enhanced-mode", + "destination": "/features/proxies", "source": "/features/stealth-mode" }, + { + "destination": "/features/proxies", + "source": "/features/enhanced-mode" + }, { "destination": "/developer-guides/llm-sdks-and-frameworks/vercel-ai-sdk", "source": "/integrations/ai-sdk" diff --git a/features/enhanced-mode.mdx b/features/enhanced-mode.mdx deleted file mode 100644 index 04fe4912..00000000 --- a/features/enhanced-mode.mdx +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: "Enhanced Mode" -description: "Use enhanced proxies for reliable scraping on complex sites" -og:title: "Enhanced Mode | Firecrawl" -og:description: "Use enhanced proxies for reliable scraping on complex sites" ---- - -import ProxyPython from "/snippets/v2/scrape/proxy/python.mdx"; -import ProxyNode from "/snippets/v2/scrape/proxy/js.mdx"; -import ProxyCURL from "/snippets/v2/scrape/proxy/curl.mdx"; - - -The `proxy` parameter no longer changes behavior. Every request runs in `auto` mode, so Firecrawl handles enhanced escalation for you automatically. - - -Firecrawl automatically uses enhanced proxies when a site needs them. Every request runs in `auto` mode: Firecrawl starts on a basic proxy and retries with enhanced proxies only if the basic proxy fails. - -## Proxy types - -| Type | Description | -|------|-------------| -| `auto` | The behavior for every request. Starts on `basic`, then retries with `enhanced` on failure. | -| `basic` | Accepted for backward compatibility. Behaves identically to `auto`. | -| `enhanced` | Accepted for backward compatibility. Behaves identically to `auto`. | - -The `proxy` parameter is optional and no longer needs to be set — all values resolve to `auto`. - -## Basic usage - -The `proxy` parameter is optional. Whether or not you set it, Firecrawl runs in `auto` mode and decides when to escalate to enhanced proxies. - - - - - - - - - - - - -Enhanced proxy requests now cost the same as basic requests — **1 credit per request**. There is no longer any extra charge when `auto` escalates to an enhanced retry. - - -> Are you an AI agent that needs a Firecrawl API key? See [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for automated onboarding instructions. diff --git a/features/proxies.mdx b/features/proxies.mdx index 07772e35..c0ee52e7 100644 --- a/features/proxies.mdx +++ b/features/proxies.mdx @@ -42,10 +42,10 @@ For full details, see the [API reference for `location.country`](https://docs.fi We highly recommend leaving `location` unspecified unless you are sure you need it. -## Proxy Types +## Proxy selection - -The `proxy` parameter no longer changes behavior. Every request now runs in **`auto`** mode: Firecrawl starts on a basic proxy and automatically escalates to enhanced proxies only if the basic proxy fails. The `basic`, `enhanced`, and `auto` values are still accepted for backward compatibility, but all behave identically — there is no way to force basic-only or enhanced-only, and enhanced retries carry no extra charge. [Learn more about Enhanced Mode →](/features/enhanced-mode) - +Firecrawl handles proxy selection for you. Every request starts on a standard proxy and, if the target site blocks or challenges it, transparently retries on a more resilient proxy — automatically, and at no extra cost. + +The `proxy` request parameter is optional and is kept only for backward compatibility. Its value no longer affects how a request is handled: every request uses automatic proxy selection. > Are you an AI agent that needs a Firecrawl API key? See [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for automated onboarding instructions. diff --git a/features/scrape.mdx b/features/scrape.mdx index 5aa2f840..76af786b 100644 --- a/features/scrape.mdx +++ b/features/scrape.mdx @@ -589,12 +589,6 @@ You can then use the job ID to check the status of the batch scrape by calling t -## Enhanced Mode - -For complex websites, Firecrawl offers enhanced mode that provides better success rates while maintaining privacy. - -Learn more about [Enhanced Mode](/features/enhanced-mode). - ## Zero Data Retention (ZDR) Firecrawl supports Zero Data Retention (ZDR) for teams with strict data handling requirements. When enabled, Firecrawl will not persist any page content or extracted data beyond the lifetime of the request. diff --git a/v1/features/proxies.mdx b/v1/features/proxies.mdx index cfc3e9cc..23b99a00 100644 --- a/v1/features/proxies.mdx +++ b/v1/features/proxies.mdx @@ -40,8 +40,8 @@ For full details, see the [API reference for `location.country`](https://docs.fi If you request a country where a proxy is not available, Firecrawl will use the closest available region (EU or US) and set the browser location to your requested country. -## Proxy Types +## Proxy selection - -The `proxy` parameter no longer changes behavior. Every request now runs in **`auto`** mode: Firecrawl starts on a basic proxy and automatically escalates to enhanced proxies only if the basic proxy fails. The `basic`, `enhanced`, and `auto` values are still accepted for backward compatibility, but all behave identically, and enhanced retries carry no extra charge. [Learn more about Enhanced Mode →](/features/enhanced-mode) - +Firecrawl handles proxy selection for you. Every request starts on a standard proxy and, if the target site blocks or challenges it, transparently retries on a more resilient proxy — automatically, and at no extra cost. + +The `proxy` request parameter is optional and is kept only for backward compatibility. Its value no longer affects how a request is handled: every request uses automatic proxy selection. diff --git a/v1/features/scrape.mdx b/v1/features/scrape.mdx index 35fa6906..fe17b4e5 100644 --- a/v1/features/scrape.mdx +++ b/v1/features/scrape.mdx @@ -223,12 +223,6 @@ You can then use the job ID to check the status of the batch scrape by calling t -## Enhanced Mode - -For complex websites, Firecrawl offers enhanced mode that provides better success rates while maintaining privacy. - -Learn more about [Enhanced Mode](/features/enhanced-mode). - ## Using FIRE-1 with Scrape You can use the FIRE-1 agent with the `/scrape` endpoint to apply intelligent navigation before scraping the final content. diff --git a/v1/features/stealth-mode.mdx b/v1/features/stealth-mode.mdx deleted file mode 100644 index e5797704..00000000 --- a/v1/features/stealth-mode.mdx +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: "Enhanced Mode" -description: "Use enhanced proxies for reliable scraping on complex sites while maintaining privacy" -og:title: "Enhanced Mode | Firecrawl" -og:description: "Use enhanced proxies for reliable scraping on complex sites while maintaining privacy" ---- - -import ProxyPython from "/snippets/v1/scrape/proxy/python.mdx"; -import ProxyNode from "/snippets/v1/scrape/proxy/js.mdx"; -import ProxyCURL from "/snippets/v1/scrape/proxy/curl.mdx"; - - -The `proxy` parameter no longer changes behavior. Every request runs in `auto` mode, so Firecrawl handles enhanced escalation for you automatically. - - -Firecrawl automatically uses enhanced proxies when a site needs them. Every request runs in `auto` mode, regardless of the `proxy` value you send. - -### Proxy Types - -- **auto**: The behavior for every request. Firecrawl starts on a basic proxy and automatically retries with enhanced proxies if it fails. -- **basic** / **enhanced**: Accepted for backward compatibility, but both behave identically to `auto`. - -The `proxy` parameter is optional and no longer needs to be set — all values resolve to `auto`. - -### Using Enhanced Mode - - - - - - - - - - - -**Note:** Enhanced proxy requests now cost the same as basic requests — 1 credit per request.