CLI

The Nimble CLI lets you run extractions, searches, crawls, and agents directly from your terminal — no code required.

Installation

Install globally with npm (Node.js 20+):

npm install -g @nimble-way/nimble-cli

Verify the installation:

nimble --version

Authentication

Set your API key as an environment variable:

export NIMBLE_API_KEY="your-api-key"

Get your API key from Settings → API Keys.

Command Structure

All commands follow a resource-based pattern:

nimble [resource] <command> [flags...]

Run nimble --help to list all resources, or nimble [resource] --help for resource-specific usage.

Core Commands

Extract

Extract clean content from any URL:

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

With JavaScript rendering and geo-targeting:

nimble extract run \
  --url "https://www.example.com" \
  --render true \
  --country US

Search

Perform a real-time web search:

nimble search --query "best web scraping tools" --country US

Map

Discover all URLs in a domain:

nimble map --url "https://www.example.com" --sitemap only

Crawl

Crawl an entire website:

nimble crawl run --url "https://www.example.com" --limit 100

Extract Template

Run a pre-built extraction template:

nimble extract:templates run --template amazon_pdp --params '{asin: B08N5WRWNW}'

Web Search Agent

Ask a research question — an agent is generated for you:

nimble agents run \
  --input "Compare the pricing of Datadog, Grafana Cloud, and New Relic."

Output Formats

Control response formatting with the --format flag:

Format	Description
`auto`	Automatic (default)
`pretty`	Pretty-printed JSON
`json`	Compact JSON
`jsonl`	JSON Lines (one object per line)
`yaml`	YAML output
`raw`	Raw API response body
`explore`	Interactive explorer view

nimble extract run --url "https://www.example.com" --format pretty

Transforming Output

Use --transform with GJSON syntax to extract specific fields:

# Extract just the task_id
nimble extract run --url "https://www.example.com" --transform "task_id"

# Extract a nested field
nimble extract run --url "https://www.example.com" --transform "data.html"

File Arguments

Pass file contents as argument values using @filename syntax:

# Pass a parser definition from a file
nimble extract run --url "https://www.example.com" --parse --parser @parser.json

Use @file://filename for plain text or @data://filename for base64-encoded content.

Global Flags

Flag	Description
`--help`	Show help for any command
`--debug`	Enable debug logging with full HTTP details
`--version`, `-v`	Display the CLI version
`--base-url`	Override the API base URL
`--format`	Set output format
`--format-error`	Set error output format
`--transform`	Transform output using GJSON syntax
`--transform-error`	Transform error output using GJSON syntax

Debug Mode

Enable --debug to inspect the full HTTP request and response — useful for troubleshooting:

nimble extract run --url "https://www.example.com" --debug

Next Steps

API Reference

Full REST API documentation for all endpoints

Extract

Extract features and parameters

Search

Real-time web search with structured results

Templates

Pre-built extraction templates for popular platforms

Getting Started

Search

Web Search Agent

Extraction Tools

Extract Template

Extract Jobs

Guides

SDKs

Admin

Proxy

Installation

Authentication

Command Structure

Core Commands

Extract

Search

Map

Crawl

Extract Template

Web Search Agent

Output Formats

Transforming Output

File Arguments

Global Flags

Debug Mode

Next Steps

API Reference

Extract

Search

Templates

​Installation

​Authentication

​Command Structure

​Core Commands

​Extract

​Search

​Map

​Crawl

​Extract Template

​Web Search Agent

​Output Formats

​Transforming Output

​File Arguments

​Global Flags

​Debug Mode

​Next Steps

API Reference

Extract

Search

Templates

Installation

Authentication

Command Structure

Core Commands

Extract

Search

Map

Crawl

Extract Template

Web Search Agent

Output Formats

Transforming Output

File Arguments

Global Flags

Debug Mode

Next Steps