Nimble

https://docs.nimbleway.com/
Admin
Nimble is a platform offering online data pipelines, an SDK, and a Web API for advanced web...
Tokens:393,192
Snippets:2,914
Trust Score:8.6
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install Go SDK

Source: https://docs.nimbleway.com/nimble-sdk/getting-started/installation

Install the Nimble Go SDK using the go get command.

```bash
go get github.com/Nimbleway/nimble-go@latest'
```

--------------------------------

### Example Agent Creation Prompts

Source: https://docs.nimbleway.com/integrations/agent-skills/web-tools-skills/nimble-agent-builder

Examples of natural language prompts to initiate agent creation or setup within the Nimble Agent Builder.

```text
"set up extraction for Amazon product pages"
  -> searches for existing agents, finds amazon_pdp, runs it, shows results
```

```text
"create a reusable scraper for job listings on LinkedIn"
  -> generates a custom agent, lets you refine fields, publishes when ready
```

```text
"build an agent for extracting hotel prices from Booking.com"
  -> creates agent from natural language, validates output, saves for reuse
```

--------------------------------

### SERP API Quick Start

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/serp

This example demonstrates how to make a POST request to the Nimble SERP API to retrieve search results. It includes the necessary headers and a sample request body.

```APIDOC
## POST /v1/serp

### Description
Fetches live Google search results as structured data.

### Method
POST

### Endpoint
/v1/serp

### Parameters
#### Request Body
- **search_engine** (string) - Required - The search engine to use (e.g., "google_search").
- **query** (string) - Required - The search query.
- **country** (string) - Optional - The country code for the search (e.g., "US").
- **locale** (string) - Optional - The locale for the search (e.g., "en").

### Request Example
```json
{
    "search_engine": "google_search",
    "query": "latest on Nimble",
    "country": "US",
    "locale": "en"
}
```

### Response
#### Success Response (200)
- **organic_results** (array) - List of organic search results.
- **pagination** (object) - Information about search result pagination.
- **related_questions** (array) - List of related questions.

#### Response Example
```json
{
  "organic_results": [
    {
      "title": "Nimble.com",
      "link": "https://www.nimble.com/",
      "snippet": "Nimble is a CRM platform..."
    }
  ],
  "pagination": {
    "next_page": "..."
  },
  "related_questions": [
    "What is Nimble?"
  ]
}
```
```

--------------------------------

### Install Nimble Agent Skills via Claude CLI

Source: https://docs.nimbleway.com/integrations/mcp-server/mcp-server

Install guided skills and the Nimble MCP server using the Claude plugin marketplace. This is the recommended method for a comprehensive setup.

```bash
claude plugin marketplace add Nimbleway/agent-skills
claude plugin install nimble@nimble-plugin-marketplace
```

--------------------------------

### Scrapy Development Setup

Source: https://docs.nimbleway.com/integrations/proxy/integration-guides/scrapy

Commands to set up a local development environment for Scrapy, including creating and activating a virtual environment, installing dependencies, and starting a new Scrapy project.

```bash
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install scrapy scrapy-nimble

# Create a new Scrapy project
scrapy startproject myproject
```

--------------------------------

### Install and Manage Skills via CLI

Source: https://docs.nimbleway.com/integrations

Install skills into a project and verify the installation.

```bash
npx skills add Nimbleway/agent-skills
```

```bash
npx skills add Nimbleway/agent-skills --list
```

--------------------------------

### Example Prompts for Competitor Positioning Analysis

Source: https://docs.nimbleway.com/integrations/agent-skills/web-search-skills/marketing

Use these example prompts to initiate the competitor positioning analysis skill. These prompts guide the skill to focus on specific aspects of competitor analysis.

```text
"competitor positioning analysis"
"messaging comparison across competitors"
"content gap analysis"
"battlecard for Stripe"
```

--------------------------------

### Installation

Source: https://docs.nimbleway.com/nimble-sdk/sdks/node

Install the Nimble JavaScript/TypeScript library using npm.

```APIDOC
## Installation

```bash
npm install @nimble-way/sdk
```

<Check>
  Requires **Node.js 20 LTS+** (also supports Deno v1.28+, Bun 1.0+, and
  Cloudflare Workers). Never hardcode your API key — use environment variables.
</Check>
```

--------------------------------

### Install Python SDK (aiohttp)

Source: https://docs.nimbleway.com/nimble-sdk/getting-started/installation

Install the nimble_python package with aiohttp support.

```bash
pip install "nimble_python[aiohttp]"
```

--------------------------------

### Install Dependencies

Source: https://docs.nimbleway.com/integrations/connectors/anthropic

Install the required packages for Python or Node.js environments.

```bash
pip install anthropic nimble_python
```

```bash
npm install @anthropic-ai/sdk @nimble-way/nimble-js
```

--------------------------------

### Install Node.js SDK

Source: https://docs.nimbleway.com/nimble-sdk/getting-started/installation

Install the Nimble JavaScript SDK for Node.js, Deno, Bun, and Cloudflare Workers.

```bash
npm install @nimble-way/nimble-js
```

--------------------------------

### Install LangChain and Nimble

Source: https://docs.nimbleway.com/integrations/connectors/langchain

Install the necessary packages for LangChain and Nimble integration. Ensure you have the latest versions.

```bash
pip install -U langchain langchain-nimble langchain-openai
```

--------------------------------

### Media Download Request Example

Source: https://docs.nimbleway.com/api-reference/openapi.json

Example payload for the /v1/media endpoint to initiate a synchronous media download.

```json
{
  "url": "https://example.com/product-image.jpg",
  "country": "US",
  "locale": "en-US",
  "expected_mime_types": [
    "image/*"
  ]
}
```

--------------------------------

### Media Download Async Response Example

Source: https://docs.nimbleway.com/api-reference/openapi.json

Example response structure for the /v1/media/async endpoint indicating a pending task.

```json
{
  "status": "success",
  "task": {
    "id": "52907745-7672-470e-1231-a2f8feb52944",
    "state": "pending",
    "created_at": "2026-03-02T12:00:00.000Z",
    "modified_at": "2026-03-02T12:00:00.000Z",
    "account_name": "my-account",
    "api_type": "media",
    "input": {
      "url": "https://example.com/product-image.jpg",
      "country": "US",
      "locale": "en-US"
```

--------------------------------

### Install Google ADK

Source: https://docs.nimbleway.com/integrations/connectors/google-adk

Install the Google ADK package using pip. This is a prerequisite for using the ADK.

```bash
pip install google-adk
```

--------------------------------

### Setup

Source: https://docs.nimbleway.com/nimble-sdk/sdks/node

Initialize the Nimble client with your API key.

```APIDOC
## Setup

Initialize the client with your API key:

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

const nimble = new Nimble({
  apiKey: process.env.NIMBLE_API_KEY,
});
```
```

--------------------------------

### Quick Start: Extract Content from URL

Source: https://docs.nimbleway.com/nimble-sdk/sdks/python

Perform a quick extraction of clean content from a given URL. This example shows how to get the task ID from the result.

```python
import os
from nimble_python import Nimble

client = Nimble(api_key=os.environ.get("NIMBLE_API_KEY"))

result = client.extract(url="https://www.example.com", render=True)
print(result.task_id)
```

--------------------------------

### Get Agent Details and Properties (Node.js)

Source: https://docs.nimbleway.com/nimble-sdk/agentic/agent-gallery

This Node.js example shows how to retrieve agent details, feature flags, and input parameters using the Nimble SDK. Make sure to install the @nimble-way/nimble-js package and provide your API key.

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

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

// Get agent details
const agent = await nimble.agent.get("amazon_pdp");

console.log(`Agent: ${agent.display_name}`);
console.log(`Description: ${agent.description}`);
console.log(`Domain: ${agent.domain}`);

// Check feature flags
const flags = agent.feature_flags;
console.log("\nCapabilities:");
console.log(
  `  Localization: ${flags.is_localization_supported ? "Yes" : "No"}`,
);
console.log(`  Pagination: ${flags.is_pagination_supported ? "Yes" : "No"}`);

// List input parameters
console.log("\nInput Parameters:");
agent.input_properties.forEach((param) => {
  const required = param.required ? "required" : "optional";
  console.log(`  ${param.name} (${param.type}) - ${required}`);
  console.log(`    ${param.description}`);
  if (param.examples?.length) {
    console.log(`    Examples: ${param.examples.join(", ")}`);
  }
});
```

--------------------------------

### Install Plugin from Local Directory

Source: https://docs.nimbleway.com/integrations/agent-skills/plugin-installation

Clones the repository and loads the plugin from a local path.

```bash
git clone https://github.com/Nimbleway/agent-skills.git
claude --plugin-dir /path/to/agent-skills
```

--------------------------------

### Formats Example (JSON)

Source: https://docs.nimbleway.com/nimble-sdk/agentic/agents

Example showing how to specify output formats for the agent response. This includes requesting 'html', 'markdown', and 'links'.

```json
"formats": ["html", "markdown", "links"]
```

--------------------------------

### Get Generation Response Example

Source: https://docs.nimbleway.com/api-reference/openapi.json

Example JSON response for a successful retrieval of an agent generation.

```json
{
  "id": "86441962-c8f5-4c24-b271-ee877d2dd865",
  "status": "success",
  "agent_name": "books_toscrape_categories_nkjansdkj_2026_03_24_zco2isqi",
  "source_version_id": "c51d09fc-c8f2-4b3a-a9bc-eaab88316217",
  "generated_version_id": "fee30209-2439-459b-985a-ba7f8d8d2325",
  "generated_version": {
    "id": "fee30209-2439-459b-985a-ba7f8d8d2325",
    "agent_name": "books_toscrape_categories_nkjansdkj_2026_03_24_zco2isqi",
    "version_number": 2,
    "metadata": {
      "vertical": "Other",
      "data_source": "books.toscrape.com",
      "display_name": "books_toscrape_categories_nkjansdkj",
      "tags": [],
      "domain": "books.toscrape.com",
      "is_displayed": false
    },
    "steps": [],
    "artifacts": {}
  },
  "summary": "Done! The agent for **books.toscrape.com** category pages is fully configured and preview ran successfully. Here's a summary of what was set up:\n\n- **Browsing**: Navigates to category pages using a URL template with `category_slug` and `category_id` as inputs (e.g., `mystery` / `3`)\n- **Parsing**: Extracts book data — `name`, `price`, `url`, and `availability` — from each listing on the category page",
  "created_at": "2026-03-24T19:19:39.300002+00:00",
  "started_at": "2026-03-24T19:19:39.307295+00:00",
  "completed_at": "2026-03-24T19:22:01.638660+00:00"
}
```

--------------------------------

### Get Driver Resolution Example

Source: https://docs.nimbleway.com/api-reference/openapi.json

Example response for a 404 Agent Not Found error during driver resolution.

```json
{
                  "status": "failed",
                  "msg": "Agent not found"
                }
```

--------------------------------

### Initialize Nimble Go Client

Source: https://docs.nimbleway.com/nimble-sdk/sdks/go

Import the package and initialize the client. Set your API key via the NIMBLE_API_KEY environment variable or pass it directly using option.WithAPIKey().

```go
package main

import (
    "context"
    "fmt"
    "os"

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

func main() {
    client := nimble.NewClient(
        option.WithAPIKey(os.Getenv("NIMBLE_API_KEY")),
    )

    _ = client
    fmt.Println("Client ready")
}
```

--------------------------------

### Localization Example (JSON)

Source: https://docs.nimbleway.com/nimble-sdk/agentic/agents

Example demonstrating how to enable localization for an agent. This includes setting the 'localization' flag and providing a 'zip_code' in the parameters.

```json
{
  "agent": "amazon_pdp",
  "localization": true,
  "params": {
    "asin": "B08N5WRWNW",
    "zip_code": "90210"
  }
}
```

--------------------------------

### Quick Start: Extract Content

Source: https://docs.nimbleway.com/nimble-sdk/sdks/node

A quick example demonstrating how to extract content from a URL in a single call.

```APIDOC
## Quick Start

Extract content from a URL in one call:

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

const nimble = new Nimble({ apiKey: process.env.NIMBLE_API_KEY });

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

console.log(result.task_id);
```
```

--------------------------------

### Initialize Nimble Python Client

Source: https://docs.nimbleway.com/home

Basic setup for the Nimble Python SDK.

```python
from nimble_python import Nimble

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

--------------------------------

### Example: Lite Search for Coding Tutorial

Source: https://docs.nimbleway.com/integrations/agent-skills/web-tools-skills/nimble-web-expert

Perform a 'lite' web search focused on the 'coding' topic for a 'React hooks tutorial'.

```bash
nimble search --query "React hooks tutorial" --topic coding --search-depth lite
```

--------------------------------

### Schema List Parser: With Position Tracking

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/extract/features/parsing-schema

Example of 'schema_list' parser configured to include an 'index' field for each item in the output list, starting from 1.

```json
{
  "type": "schema_list",
  "selector": { ... },
  "fields": {
    "field_name": { /* Parser */ }
  },
  "position": {
    "field_name": "index",
    "start_from": 1  // Optional, defaults to 0
  }
}
```

--------------------------------

### Agent Parameters Example (JSON)

Source: https://docs.nimbleway.com/nimble-sdk/agentic/agents

Example of agent-specific parameters for fetching product data. This demonstrates the 'asin' parameter commonly used for product agents.

```json
{
  "asin": "B08N5WRWNW"
}
```

--------------------------------

### Company Deep Dive Example Prompts

Source: https://docs.nimbleway.com/integrations/agent-skills/web-search-skills/business-research

Use these prompts to get a comprehensive report on a specific company, covering funding, leadership, product, market position, news, and strategic outlook.

```text
"tell me about Stripe"
"due diligence on Figma"
"background on Cloudflare before our partnership call"
```

--------------------------------

### Initialize Go Client with API Key

Source: https://docs.nimbleway.com/nimble-sdk/getting-started/installation

Initialize the Nimble Go client directly with an API key using options. Not recommended for production.

```go
import (
    nimble "github.com/Nimbleway/nimble-go"
    "github.com/Nimbleway/nimble-go/option"
)

client := nimble.NewClient(option.WithAPIKey("your-api-key"))
```

--------------------------------

### Parse Network Capture Data with Root and JSON Selector

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/extract/features/parsing-schema

This example shows how to extract network capture data from the page. It uses a sequence selector starting with 'root' and then a JSON path to the 'network_capture' field.

```json
{
  "type": "terminal",
  "selector": {
    "type": "sequence",
    "sequence": [
      {
        "type": "root"
      },
      {
        "type": "json",
        "path": "$.network_capture"
      }
    ]
  },
  "extractor": {
    "type": "raw"
  }
}
```

--------------------------------

### Browser Emulation Configuration

Source: https://docs.nimbleway.com/api-reference/crawl/create-crawl

Examples for configuring browser type and version emulation.

```yaml
chrome
```

```yaml
144.0.0
```

--------------------------------

### Prompt Example: Monitor Product Catalog

Source: https://docs.nimbleway.com/nimble-sdk/getting-started/quickstart

Extract product information from a given URL and save it to a JSON file.

```plaintext
Extract all product names, prices, and categories from https://www.allbirds.com/collections/mens
and save the results to a JSON file.
```

--------------------------------

### Get Crawl Status by ID Response Example

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/crawl

This JSON object shows the response when retrieving the status of a crawl job by its ID. It includes progress counters, the status of individual tasks, and completion timestamps.

```json
{
    "crawl": {
        "crawl_id": "e3ca2ff1-b82a-472b-b1a9-ef4d29cc549f",
        "name": null,
        "url": "https://www.nimbleway.com",
        "status": "succeeded",
        "account_name": "your-account",
        "total": 10,
        "pending": 0,
        "completed": 10,
        "failed": 0,
        "created_at": "2026-02-09T23:15:40.785Z",
        "updated_at": "2026-02-09T23:17:08.083Z",
        "completed_at": "2026-02-09T23:17:08.079Z",
        "crawl_options": {
            "sitemap": "include",
            "crawl_entire_domain": false,
            "limit": 10,
            "max_discovery_depth": 5
        },
        "extract_options": null,
        "tasks": [
            {
                "task_id": "ec89b1f7-1cf2-40eb-91b4-78716093f9ed",
                "status": "completed",
                "updated_at": "2026-02-09T23:16:39.094Z",
                "created_at": "2026-02-09T23:15:43.549Z"
            },
            {
                "task_id": "3f6c136c-4bb5-44af-a21b-c8f1db708c2f",
                "status": "completed",
                "updated_at": "2026-02-09T23:16:45.033Z",
                "created_at": "2026-02-09T23:15:42.966Z"
            }
        ]
    }
}
```

--------------------------------

### Get Agent Details and Properties (Python)

Source: https://docs.nimbleway.com/nimble-sdk/agentic/agent-gallery

Use this Python snippet to fetch agent information, including its display name, description, domain, feature flags, and input parameters. Ensure you have the nimble_python library installed and your API key configured.

```python
from nimble_python import Nimble

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

# Get agent details
agent = nimble.agent.get("amazon_pdp")

print(f"Agent: {agent.display_name}")
print(f"Description: {agent.description}")
print(f"Domain: {agent.domain}")

# Check feature flags
flags = agent.feature_flags
print(f"\nCapabilities:")
print(f"  Localization: {'Yes' if flags.is_localization_supported else 'No'}")
print(f"  Pagination: {'Yes' if flags.is_pagination_supported else 'No'}")

# List input parameters
print(f"\nInput Parameters:")
for param in agent.input_properties:
    required = "required" if param.required else "optional"
    print(f"  {param.name} ({param.type}) - {required}")
    print(f"    {param.description}")
    if param.examples:
        print(f"    Examples: {', '.join(param.examples)}")
```

--------------------------------

### Example Output for Product Parser

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/extract/features/parsing-schema

Provides an example of the structured JSON output generated by the complete product parser schema.

```json
{
    "title": "Apple Watch Series 9 GPS 45mm Midnight Aluminum Case with Midnight Sport Band - M/L",
    "image_url": "https://target.scene7.com/is/image/Target/GUEST_3ad473cc-8f21-44c8-85ca-b9a1dee1806c",
    "price": 399.0,
}
```

--------------------------------

### Verify Vercel CLI Skill Installation

Source: https://docs.nimbleway.com/integrations/agent-skills/plugin-installation

Command to list installed skills to verify successful installation.

```bash
npx skills add Nimbleway/agent-skills --list
```

--------------------------------

### Install Skills for Vercel CLI

Source: https://docs.nimbleway.com/nimble-sdk/sdks/skills

Add skills and manually connect the MCP server.

```bash
npx skills add Nimbleway/agent-skills
```

```bash
claude mcp add --transport http nimble-mcp-server https://mcp.nimbleway.com/mcp \
  --header "Authorization: Bearer ${NIMBLE_API_KEY}"
```

--------------------------------

### Fetch Google AI results beyond the first 100

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/serp

Combine `num_results: 100` with the `start` parameter to fetch results in batches of 100. Increment `start` by 100 for each subsequent batch (e.g., `start: 100` for results 101-200, `start: 200` for results 201-300).

```bash
curl -X POST 'https://sdk.nimbleway.com/v1/serp' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search_engine": "google_aio",
    "query": "how does photosynthesis work",
    "country": "US",
    "locale": "en",
    "num_results": 100,
    "start": 100
}'
```

--------------------------------

### Fetch subsequent Google Search results beyond 100

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/fast-serp

To retrieve more than 100 results for Google Search, combine `num_results: 100` with the `start` parameter. Increment `start` by 100 for each subsequent batch (e.g., `start: 100` for results 101-200, `start: 200` for results 201-300).

```bash
curl -X POST 'https://api.us.webit.live/api/v1/realtime/serp' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search_engine": "google_search",
    "query": "NBA Allstar 2026",
    "num_results": 100,
    "start": 100
}'
```

--------------------------------

### Example: Map Website Pages

Source: https://docs.nimbleway.com/integrations/agent-skills/web-tools-skills/nimble-web-expert

Discover and map all pages on a given website URL, limiting the results to 100 pages.

```bash
nimble map --url "https://docs.example.com" --limit 100
```

--------------------------------

### GET /v1/tasks/{task_id}/results

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/crawl

Get extracted content for a page.

```APIDOC
## GET /v1/tasks/{task_id}/results

### Description
Retrieves the extracted content for a specific task (page).

### Method
GET

### Endpoint
/v1/tasks/{task_id}/results

### Parameters
#### Path Parameters
- **task_id** (string) - Required - The ID of the task.
```

--------------------------------

### Verify Installation with Smoke Tests

Source: https://docs.nimbleway.com/integrations/partnerships/databricks/data-enrichment

Runs sample queries to confirm that web search and page extraction tools are functioning correctly.

```sql
-- Web search → expect ~10 rows of live results (title + url populated)
SELECT title, url
FROM   nimble_integration.tools.nimble_search('AI agent frameworks news', 10);

-- Page extraction → expect a snippet of real extracted markdown
SELECT substr(content, 1, 300) AS preview
FROM   nimble_integration.tools.nimble_extract('https://www.nimbleway.com');
```

--------------------------------

### Install Skills in Cortex Code

Source: https://docs.nimbleway.com/nimble-sdk/sdks/skills

Add skills from the repository and verify the installation.

```bash
cortex skill add https://github.com/Nimbleway/agent-skills.git
```

```bash
/skill add https://github.com/Nimbleway/agent-skills.git
```

```bash
/skill list
```

--------------------------------

### Install Nimble CLI

Source: https://docs.nimbleway.com/integrations/agent-skills/plugin-installation

Installs the Nimble CLI globally via npm.

```bash
npm i -g @nimble-way/nimble-cli
```

--------------------------------

### Configure Native App with SQL

Source: https://docs.nimbleway.com/integrations/partnerships/snowflake/native-app

Registers API keys and external access integrations, then initializes the required EAI objects.

```sql
CALL nimble_search.config.register_reference(
  'nimble_api_key', 'ADD',
  SYSTEM$REFERENCE('SECRET','NIMBLE_INTEGRATION.TOOLS.NIMBLE_API_KEY','PERSISTENT','READ'));

CALL nimble_search.config.register_reference(
  'nimble_external_access', 'ADD',
  SYSTEM$REFERENCE('EXTERNAL_ACCESS_INTEGRATION','NIMBLE_API_ACCESS','PERSISTENT','USAGE'));

CALL nimble_search.core.create_eai_objects();
```

--------------------------------

### Install Puppeteer and proxy-chain

Source: https://docs.nimbleway.com/integrations/proxy/integration-guides/puppeteer

Install the necessary Node.js packages for Puppeteer and proxy authentication.

```bash
npm install puppeteer proxy-chain
```

--------------------------------

### Clone Nimble Cookbook

Source: https://docs.nimbleway.com/integrations/partnerships/databricks/data-enrichment

Downloads the repository containing the necessary SQL scripts and deployment helpers.

```bash
git clone https://github.com/Nimbleway/cookbook.git
cd cookbook
```

--------------------------------

### Install Scrapy-Nimble Package

Source: https://docs.nimbleway.com/integrations/proxy/integration-guides/scrapy

Install the official Nimble middleware for Scrapy using pip.

```bash
pip install scrapy-nimble
```

--------------------------------

### Example List Tasks Response

Source: https://docs.nimbleway.com/nimble-sdk/web-tools/extract/features/async

A sample JSON response for listing tasks, including task details and pagination information. The `download_url` can be used to directly access results for completed tasks.

```json
{
  "data": [
    {
      "id": "8e8cfde8-...",
      "state": "success",
      "batch_id": "b7e1a2f3-...",
      "api_type": "extract",
      "created_at": "2026-03-19T10:00:00.000Z",
      "download_url": "https://sdk.nimbleway.com/v1/tasks/8e8cfde8-.../results"
    }
  ],
  "pagination": {
    "has_next": true,
    "next_cursor": "eyJpZCI6Ij...",
    "total": 142
  }
}
```

--------------------------------

### Metadata Example

Source: https://docs.nimbleway.com/api-reference/openapi.json

Example values for extraction metadata including driver and agent identifiers.

```json
"driver": [
  "vx8"
]
```

```json
"agent": [
  "amazon_pdp"
]
```

--------------------------------

### Task ID Example

Source: https://docs.nimbleway.com/api-reference/openapi.json

Example of a UUID used as a task identifier in path parameters.

```json
"8e8cfde8-345b-42b8-b3e2-0c61eb11e00f"
```

--------------------------------

### Initialize Python Client with API Key

Source: https://docs.nimbleway.com/nimble-sdk/getting-started/installation

Initialize the Nimble Python client directly with an API key. Not recommended for production.

```python
from nimble_python import Nimble

client = Nimble(api_key="your-api-key")
```
Tokens:
Raw