Prefer not to write code? Install the Nimble
plugin and describe what you
need in plain language — your AI assistant handles the rest. See the
Quickstart Guide for prompt
examples.
Installation
pip install nimble_python
npm install @nimble-way/sdk
Web Search Agents
Run pre-built agents for popular sites, or create one for any website:from nimble_python import Nimble
nimble = Nimble(api_key="YOUR-API-KEY")
result = nimble.agent.run(
agent="amazon_pdp",
params={
"asin": "B08N5WRWNW"
}
)
parsed = result.data.parsing["parsed"]
print(f"Product: {parsed['product_title']}")
print(f"Price: ${parsed['web_price']}")
import Nimble from "@nimble-way/nimble-js";
const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });
const result = await nimble.agent.run({
agent: "amazon_pdp",
params: {
asin: "B08N5WRWNW",
},
});
const parsed = result.data.parsing.parsed;
console.log(`Product: ${parsed.product_title}`);
console.log(`Price: $${parsed.web_price}`);
curl -X POST 'https://sdk.nimbleway.com/v1/agents/run' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"agent": "amazon_pdp",
"params": {
"asin": "B08N5WRWNW"
}
}'
Extract
Get clean HTML and structured data from any URL:from nimble_python import Nimble
nimble = Nimble(api_key="YOUR-API-KEY")
result = nimble.extract(
url="https://www.example.com",
render=True,
formats=["html", "markdown"]
)
print(result.data.html)
import Nimble from "@nimble-way/nimble-js";
const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });
const result = await nimble.extract({
url: "https://www.example.com",
render: true,
formats: ["html", "markdown"],
});
console.log(result.data.html);
curl -X POST 'https://sdk.nimbleway.com/v1/extract' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"url": "https://www.example.com",
"render": true,
"formats": ["html", "markdown"]
}'
Search
Real-time web search with structured results:from nimble_python import Nimble
nimble = Nimble(api_key="YOUR-API-KEY")
result = nimble.search(
query="latest developments in AI agents",
max_results=5,
include_answer=True
)
print(f"AI Answer: {result.answer}")
for r in result.results:
print(f"- {r.title}: {r.url}")
import Nimble from "@nimble-way/nimble-js";
const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });
const result = await nimble.search({
query: "latest developments in AI agents",
max_results: 5,
include_answer: true,
});
console.log(`AI Answer: ${result.answer}`);
result.results.forEach((r) => {
console.log(`- ${r.title}: ${r.url}`);
});
curl -X POST 'https://sdk.nimbleway.com/v1/search' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"query": "latest developments in AI agents",
"max_results": 5,
"include_answer": true
}'
Map
Fast URL discovery and site structure mapping:from nimble_python import Nimble
nimble = Nimble(api_key="YOUR-API-KEY")
result = nimble.map(
url="https://www.example.com",
sitemap="include"
)
for link in result.links:
print(f"{link.title}: {link.url}")
import Nimble from "@nimble-way/nimble-js";
const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });
const result = await nimble.map({
url: "https://www.example.com",
sitemap: "include",
});
result.links.forEach((link) => {
console.log(`${link.title}: ${link.url}`);
});
curl -X POST 'https://sdk.nimbleway.com/v1/map' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"url": "https://www.example.com",
"sitemap": "include"
}'
Crawl
Extract content from entire websites:from nimble_python import Nimble
nimble = Nimble(api_key="YOUR-API-KEY")
result = nimble.crawl.run(
url="https://docs.example.com",
limit=10
)
print(f"Crawl started: {result.crawl_id}")
print(f"Tasks: {len(result.tasks)}")
import Nimble from "@nimble-way/nimble-js";
const nimble = new Nimble({ apiKey: "YOUR-API-KEY" });
const result = await nimble.crawl.run({
url: "https://docs.example.com",
limit: 10,
});
console.log(`Crawl started: ${result.crawl_id}`);
console.log(`Tasks: ${result.tasks.length}`);
curl -X POST 'https://sdk.nimbleway.com/v1/crawl' \
--header 'Authorization: Bearer <YOUR-API-KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"url": "https://docs.example.com",
"limit": 10
}'
Next steps
Web Search Agents
Learn about intelligent agents that work with any website
Extract Docs
Full Extract API documentation with all parameters
API Reference
Complete API reference for all endpoints
Install Plugin
Use Nimble in Claude Code or Cursor instead of writing code