Skip to main content
Nimble Search delivers real-time web search powered by Web Search Agents (WSAs) that understand query intent and return structured, agent-ready data. Unlike generic search engines, WSAs navigate websites directly to extract deeper insights and format results for seamless AI integration. Perfect for AI agents, research automation, competitive intelligence, content monitoring, and any application that needs real-time web data with structured outputs.

​
Quick Start

​
Example Request

from nimble_python import Nimble

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

result = nimble.search(
    query="latest developments in AI agents 2026",
    max_results=5,
    search_depth="lite"
)

print(f"Found {len(result.results)} results")
for item in result.results:
    print(f"- {item.title}: {item.url}")

​
Example Response

{
  "total_results": 5,
  "results": [
    {
      "title": "AI Agents: The Next Frontier in 2026",
      "description": "Exploring the latest breakthroughs in autonomous AI agents...",
      "url": "https://example.com/ai-agents-2026",
      "metadata": {
        "position": 1,
        "entity_type": "OrganicResult",
        "country": "US",
        "locale": "en"
      }
    },
    {
      "title": "Autonomous Agents and Tool Use",
      "description": "How modern AI agents interact with external tools and APIs...",
      "url": "https://example2.com/agent-tools",
      "metadata": {
        "position": 2,
        "entity_type": "OrganicResult",
        "country": "US",
        "locale": "en"
      }
    },
    {...}
  ],
  "request_id": "84f08ac1-bb5f-4b6f-8447-2d21cb930416"
}

​
Search Depth

The search_depth parameter controls how much content each search returns. Choose the right depth for your use case.
DepthContent ReturnedCreditsBest For
lite (default)Titles, URLs, snippets1 per searchURL discovery, high-volume pipelines, quick filtering
fastRich content2 per searchRAG, chatbots, real-time AI agent workflows
deepFull real-time page extraction1 + 1 per pageResearch, due diligence, comprehensive analysis
fast mode is an enterprise feature. Contact sales to enable it for your account. Currently supported with focus: "general" only.

Search Depth Best Practices

Learn when to use each depth mode, optimization tips, and cost strategies.

Lite — metadata only

Get titles, URLs, and snippets for fast, token-efficient pipelines. 1 credit per search.
from nimble_python import Nimble

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

result = nimble.search(
    query="best web scraping tools 2026",
    max_results=10,
    search_depth="lite"
)

for item in result.results:
    print(f"{item.title}: {item.url}")
Rich content at low latency, optimized for AI agents. 2 credits per search.
from nimble_python import Nimble

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

result = nimble.search(
    query="python async best practices",
    max_results=5,
    search_depth="fast"
)

for item in result.results:
    print(f"Title: {item.title}")
    print(f"Content: {item.description[:200]}...")
fast mode requires an enterprise account and only works with focus: "general". Contact sales to get access.
Extract full page content from every result for comprehensive analysis. 1 credit per search + 1 credit per page extracted.
from nimble_python import Nimble

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

result = nimble.search(
    query="python web scraping tutorial",
    max_results=5,
    search_depth="deep",
    output_format="markdown"
)

for item in result.results:
    print(f"Title: {item.title}")
    print(f"URL: {item.url}")
    print(f"Content: {item.content[:200]}...")
    print("---")

​
Parameters

API Parameters

For detailed parameter documentation, see the Search API Reference.

​
Key Features

Get an AI-generated answer based on search results. Returns an instant summary with inline citations, perfect for Q&A systems, chatbots, and research assistants.
from nimble_python import Nimble

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

result = nimble.search(
    query="what are the benefits of TypeScript over JavaScript",
    max_results=10,
    include_answer=True
)

print("AI Answer:")
print(result.answer)

print("\nSources:")
for item in result.results:
    print(f"- {item.title}: {item.url}")
Filter results by recency using time_range or specify exact date ranges. Essential for news monitoring, tracking recent developments, or analyzing historical data within specific timeframes.
from nimble_python import Nimble

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

# Filter by time range
result = nimble.search(
    query="AI news",
    max_results=20,
    time_range="week"
)

# Or use specific date range
result = nimble.search(
    query="machine learning advances",
    max_results=15,
    start_date="2026-01-01",
    end_date="2026-01-31"
)

print(result)
Filter results to specific domains or exclude unwanted ones. Focus on trusted sources, exclude noise (social media, ads), or search within curated lists of authoritative sites.
from nimble_python import Nimble

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

# Only search within specific domains
result = nimble.search(
    query="python async patterns",
    max_results=10,
    include_domains=["github.com", "stackoverflow.com", "docs.python.org"]
)

# Or exclude specific domains
result = nimble.search(
    query="web scraping tutorial",
    max_results=10,
    exclude_domains=["pinterest.com", "youtube.com"]
)

print(result)
Search for specific document types like PDFs, spreadsheets, or presentations (only works with focus: "general"). Perfect for academic research, finding reports, whitepapers, or structured data files.
from nimble_python import Nimble

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

# Search for PDF documents
result = nimble.search(
    query="machine learning research papers",
    max_results=10,
    focus="general",
    content_type=["pdf"]
)

# Search for multiple document types
result = nimble.search(
    query="financial reports 2026",
    max_results=15,
    focus="general",
    content_type=["pdf", "xlsx", "docx"]
)

# Use semantic groups for broader filtering
result = nimble.search(
    query="quarterly earnings",
    max_results=10,
    focus="general",
    content_type=["documents", "spreadsheets"]
)

print(result)
content_type only works with focus: "general". Supported formats: pdf, docx, xlsx, pptx, and semantic groups: documents, spreadsheets, presentations.

​
Topic Modes

Topic modes route your searches to specialized sources optimized for different use cases. Each mode uses dedicated Web Search Agents to retrieve the most relevant results.

​
Available Pre-defined Modes

Pre-defined focus modes automatically route your search to specialized Nimble Web Search Agents (WSA) based on your query type. Simply specify the mode that matches your use case.
Topic ModeBest For
general (default)General information, broad topics, web pages
newsCurrent events, breaking stories, journalism
codingCode examples, debugging, API documentation
academicScientific research, peer-reviewed studies
shoppingProduct comparison, pricing, merchant reviews
socialSocial content, influencers, trending topics
geoAI-generated answers, synthetic insights
locationPlaces, businesses, geographic information
Compare products across e-commerce platforms: 
from nimble_python import Nimble

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

result = nimble.search(
    query="wireless noise canceling headphones",
    focus="shopping",
    max_results=20,
    max_subagents=5  # Search more platforms in parallel
)

print(result)

​
Custom Focus Mode

For advanced use cases, you can explicitly specify which search agents to use by passing an array of subagent names to the focus parameter. This gives you full control over data sources and enables mixing agents from different focus modes. Example: 
{
  "query": "best wireless headphones",
  "focus": ["amazon_serp", "walmart_serp", "reddit_discover_posts"],
  "max_results": 10
}

Available Web Search Agents (WSA)

View the complete list of Web Search Agents you can use in custom focus modes.

​
Use cases

Research & Data Collection

Gather comprehensive information on any topic from multiple sources automatically

AI Agent Tasks

Get quick web answers with optional LLM-generated summaries for your applications

Content Monitoring

Track mentions, news, or updates about specific topics, brands, or keywords

Competitive Intelligence

Monitor what’s being said about competitors or track industry trends

​
Search vs other tools

NeedUse
Search web + extract content from resultsSearch
Domain-specific agentsPublic Agent - maintained by Nimble
Data from sources not in the galleryCustom Agent - create with natural language
Data from specific URLsExtract
URLs with context for AI planningMap
Data from entire websiteCrawl

​
Next steps

API Reference

Explore endpoints, request parameters, and response schemas for the Search API

Web Tools Skill

Add real-time web intelligence tools to Claude Code and other AI agents

LangChain Integration

Connect Nimble Search to your LangChain applications