Max Driver

The max driver sends one request to every Nimble driver at the same time and returns the first successful response. Use it when speed and success rate matter more than cost. Common uses:

Latency-sensitive agents: get the page back as fast as any driver can fetch it.
Hard targets: let stealth and rendering drivers race instead of escalating one at a time.
Unknown sites: skip driver tuning when the site mix changes from request to request.

max is a premium driver billed at $2.50 per 1K URLs. Only the successful response is charged. Failed requests are free. See Pricing.

Quick Start

Example Request

from nimble_python import Nimble

nimble = Nimble(api_key="YOUR-API-KEY")

result = nimble.extract.run(
    url="https://www.example.com",
    driver="max"
)

print(result.data.html)

import Nimble from "@nimble-way/nimble-js";

const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });

const result = await nimble.extract.run({
  url: "https://www.example.com",
  driver: "max",
});

console.log(result.data?.html);

curl -X POST 'https://sdk.nimbleway.com/v2/extract' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.example.com",
    "driver": "max"
}'

nimble extract run \
  --url "https://www.example.com" \
  --driver max

Example Response

{
  "url": "https://www.example.com",
  "task_id": "b1fa7943-cba5-4ec2-a88c-4d2d6799c794",
  "status": "success",
  "data": {
    "html": "<!DOCTYPE html><html>...</html>",
    "headers": {}
  },
  "metadata": {
    "query_time": "2026-11-03T09:12:41.207Z",
    "query_duration": 1412,
    "driver": "max"
  },
  "status_code": 200
}

How it works

You send one request with driver: max

Pass driver: "max" with the URL. No other driver settings are needed.

Nimble starts every driver at the same time

The request is sent to all drivers in parallel, from plain HTTP (vx6) to stealth headful browsers (vx10-pro). Each driver uses its own rendering settings.

The first successful response wins

As soon as one driver returns a valid page, that response is sent back to you. Slower attempts keep running in the background. They do not delay the response and are not charged.

Failures are reported only if every driver fails

If no driver succeeds, the request fails once with the final error. Failed requests are not charged.

Parameters

driver

string

Set to "max" to run every driver in parallel and return the first successful response.Works with: formats, country, state, city, locale, parse, headers, cookies, and request_timeout.Cannot be combined with: render: "auto" or auto_driver_configuration. Sending either together with driver: "max" returns a 400 error.Rendering: leave render unset. Each driver in the race applies its own rendering configuration, so both non-rendered and rendered results compete.

Example:

"driver": "max"

request_timeout

number

Maximum time in milliseconds to wait for the whole request. The timeout caps the race as a whole, not each driver. If no driver succeeds before the deadline, the request fails.

Example:

"request_timeout": 30000

Max vs. auto

Both options let Nimble pick the driver for you. They optimize for different things.

	`render: "auto"`	`driver: "max"`
How	One driver at a time	All drivers at once
Best for	Lowest cost	Fastest result
Latency	Grows per escalation	Quickest driver
Billing	Driver that succeeded	$2.50 / 1K URLs
Tuning	`auto_driver_configuration`	None

Pick render: "auto" for high-volume jobs where cost matters. Pick driver: "max" for real-time workloads, agent tool calls, and sites that block cheaper drivers.

max runs every driver for every request, so it costs more per URL than a single driver. Do not use it for large crawls of simple static pages. Use vx6 or render: "auto" instead.

Usage

Fetch a protected page as fast as possible

Let stealth and rendering drivers race against plain HTTP. The response comes from whichever gets through first.

from nimble_python import Nimble

nimble = Nimble(api_key="YOUR-API-KEY")

result = nimble.extract.run(
    url="https://www.protected-site.com/product/123",
    driver="max",
    formats=["markdown"]
)

print(result.data.markdown)

import Nimble from "@nimble-way/nimble-js";

const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });

const result = await nimble.extract.run({
  url: "https://www.protected-site.com/product/123",
  driver: "max",
  formats: ["markdown"],
});

console.log(result.data?.markdown);

curl -X POST 'https://sdk.nimbleway.com/v2/extract' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.protected-site.com/product/123",
    "driver": "max",
    "formats": ["markdown"]
}'

nimble extract run \
  --url "https://www.protected-site.com/product/123" \
  --driver max \
  --format markdown

Cap the wait time

Combine max with request_timeout to fail fast when no driver gets through.

from nimble_python import Nimble

nimble = Nimble(api_key="YOUR-API-KEY")

result = nimble.extract.run(
    url="https://www.example.com",
    driver="max",
    request_timeout=30000
)

print(result.status)

import Nimble from "@nimble-way/nimble-js";

const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });

const result = await nimble.extract.run({
  url: "https://www.example.com",
  driver: "max",
  request_timeout: 30000,
});

console.log(result.status);

curl -X POST 'https://sdk.nimbleway.com/v2/extract' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.example.com",
    "driver": "max",
    "request_timeout": 30000
}'

nimble extract run \
  --url "https://www.example.com" \
  --driver max \
  --request-timeout 30000

JS Rendering

Automatic driver selection with render: "auto"

Stealth Mode

Pick a single stealth driver by hand

Advanced Options

Timeouts, sessions, and device emulation

Pricing

Extract pricing, including the max driver

Getting Started

Search Tools

Agent

Extraction Tools

Extract Template

Extract Jobs

Guides

SDKs

Admin

Proxy

Quick Start

Example Request

Example Response

How it works

Parameters

Max vs. auto

Usage

Fetch a protected page as fast as possible

Cap the wait time

JS Rendering

Stealth Mode

Advanced Options

Pricing

​Quick Start

​Example Request

​Example Response

​How it works

​Parameters

​Max vs. auto

​Usage

​Fetch a protected page as fast as possible

​Cap the wait time

​Related

JS Rendering

Stealth Mode

Advanced Options

Pricing

Quick Start

Example Request

Example Response

How it works

Parameters

Max vs. auto

Usage

Fetch a protected page as fast as possible

Cap the wait time

Related