Domain Knowledge

Look up which driver Nimble recommends for a given domain or agent — including detected antibot systems and whether JavaScript rendering is required. Use the result to set the driver parameter explicitly on Extract or Agent requests.

Nimble selects the optimal driver automatically on every request. Use Domain Knowledge when you want to understand the driver tier before running at scale, or to pin a specific tier for cost predictability.

Quick Start

Example Request

from nimble_python import Nimble

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

# By URL — or pass agent="target_serp" instead
result = nimble.domain_knowledge.get_driver(url="www.lowes.com")

print(result.model_dump())

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

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

// By URL — or pass { agent: "target_serp" } instead
const result = await nimble.domainKnowledge.getDriver({ url: "www.lowes.com" });

console.log(result);

package main

import (
    "context"
    "fmt"

    nimble "github.com/Nimbleway/nimble-go"
    "github.com/Nimbleway/nimble-go/option"
    "github.com/Nimbleway/nimble-go/packages/param"
)

func main() {
    client := nimble.NewClient(option.WithAPIKey("YOUR-API-KEY"))

    // By URL — or set Agent instead
    result, err := client.DomainKnowledge.GetDriver(context.Background(), nimble.DomainKnowledgeGetDriverParams{
        URL: param.NewOpt("www.lowes.com"),
    })
    if err != nil {
        panic(err)
    }
    fmt.Printf("%+v\n", result)
}

# By URL — or pass --agent target_serp instead
nimble domain-knowledge get-driver --url www.lowes.com

curl -X GET 'https://sdk.nimbleway.com/v2/domain-knowledge/driver?url=www.lowes.com' \
--header 'Authorization: Bearer <YOUR-API-KEY>'

Example Response

{
  "url": "www.lowes.com",
  "driver": "vx6",
  "antibots": ["akamai", "threatmetrix", "recaptcha", "akamai-sbsd"],
  "description": "Native Driver - non rendered fast request",
  "need_to_render": false
}

Agent lookup response:

{
  "agent": "target_serp",
  "driver": "wsa-10m",
  "antibots": ["perimeterx", "f5-shape", "recaptcha"],
  "description": "Stealth Driver - stealth browser with advanced bypassing any site, for Agents managed by Nimble",
  "need_to_render": true
}

How it works

Submit a URL or agent name

Pass either a url (domain) or agent name as a query parameter. Exactly one must be provided.

Nimble resolves the driver

Nimble queries its domain knowledge database to identify the antibot systems protecting the target and returns the recommended driver.

Pin the driver on your Extract or Agent request

Use the returned driver value in the driver parameter of an Extract or Agent request to skip auto-detection and use the resolved tier directly.

Parameters

url

string

Target domain to resolve the driver for.Example: amazon.comMutually exclusive with agent — provide exactly one.

agent

string

Agent name to resolve the driver for.Example: amazon_pdpMutually exclusive with url — provide exactly one.

Response fields

Field	Type	Description
`driver`	string	Recommended driver (e.g. `vx6`, `vx8`, `vx10`, `wsa-6m`)
`description`	string	Human-readable description of the driver
`antibots`	array	Antibot systems detected on the domain (e.g. `cloudflare`, `perimeterx`, `recaptcha`)
`need_to_render`	boolean	Whether JavaScript rendering is required
`url`	string	Echoed input (present when `url` query param was used)
`agent`	string	Echoed input (present when `agent` query param was used)

Using the result with Extract

Pass the resolved driver value directly to an Extract request to skip auto-detection.

If the resolved driver is a wsa-* value, use the equivalent vx driver instead when calling Extract. See the conversion table below.

Agent driver	Extract driver
`wsa-6` / `wsa-6m`	`vx6`
`wsa-8` / `wsa-8m`	`vx8`
`wsa-10` / `wsa-10m`	`vx10`

cURL

# Step 1 — resolve the driver
curl -s -X GET 'https://sdk.nimbleway.com/v2/domain-knowledge/driver?url=www.lowes.com' \
--header 'Authorization: Bearer <YOUR-API-KEY>'

# Step 2 — use the resolved driver in Extract
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.lowes.com/pl/Drills/4294857312",
    "driver": "<DRIVER>"
}'

Extract

Use the resolved driver in Extract requests via the driver parameter

Templates

Resolve the driver for any template

Pricing

Understand how driver tiers affect request cost

Getting Started

Search

Web Search Agent

Extraction Tools

Extract Template

Extract Jobs

Guides

SDKs

Admin

Proxy

Quick Start

Example Request

Example Response

How it works

Parameters

Response fields

Using the result with Extract

Extract

Templates

Pricing

​Quick Start

​Example Request

​Example Response

​How it works

​Parameters

​Response fields

​Using the result with Extract

​Related

Extract

Templates

Pricing

Quick Start

Example Request

Example Response

How it works

Parameters

Response fields

Using the result with Extract

Related