Search

Nimble Search executes web searches and automatically retrieves clean, structured content from the top results. Ask a question or enter keywords, and get back both the URLs and the full parsed content from each result.

Quick Start

Example Request

from nimble_python import Nimble

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

result = nimble.search({
    "query": "best web scraping tools 2026"
})

print(f"Found {len(result['results'])} results")

Example Response

{
  "total_results": 5,
  "results": [
    {
      "title": "Top 10 Web Scraping Tools for 2026",
      "description": "Comprehensive guide to the best web scraping tools...",
      "url": "https://example.com/article1",
      "content": "# Top 10 Web Scraping Tools\n\nWeb scraping has become essential...",
      "metadata": {
        "position": 1,
        "entity_type": "OrganicResult",
        "country": "US",
        "locale": "en"
      }
    },
    {
      "title": "Web Scraping Tools Comparison",
      "description": "Compare features, pricing, and performance...",
      "url": "https://example2.com/comparison",
      "content": "# Web Scraping Tools Comparison\n\nChoosing the right tool..."
    }
  ],
  "request_id": "84f08ac1-bb5f-4b6f-8447-2d21cb930416"
}

How it works

You provide a search query

Give Search any question or keywords you want to search for

Search executes on major search engines

Runs your query across search engines
Retrieves top matching results
Identifies most relevant pages

Extracts content from results

Visits each result page (in Deep Search mode)
Parses full page content automatically
Cleans and structures the text
Optional: Generates AI summary of findings

Returns structured results

Get search results with titles, descriptions, URLs, and full content ready to use

Parameters

Supported input parameters:

query - Required

query

string

required

What you want to search for. Can be a simple keyword, a question, or a detailed search phrase.Example: best web scraping tools 2026

num_results

integer

default:"3"

How many search results you want back.

Min: 1
Max: 100
Default: 3

deep_search

boolean

default:"true"

Choose between getting full page content or just basic info.Options:

true (default) - Get full content from each result page (deeper insights, slower)
false - Get just title, snippet, and URL (faster, less detail)

parsing_type

string

How you want the content formatted when using deep search.Options:

markdown - Clean, readable format perfect for documentation or LLMs
plain_text - Just the text, no formatting
simplified_html - HTML with the clutter removed

focus

string

Specialize your search for specific types of content.Options:

general - Standard web search (works for everything)
news - Focus on news articles and current events
location - Find location-based information
coding - Search for programming and technical docs
geo - Geographic and map-related results
shopping - Product searches and e-commerce
social - Social media content

include_answer

boolean

default:"false"

Get an AI-generated answer to your question based on the search results. Perfect for quick research or building Q&A systems.Works with both fast and deep search modes.

country

string

default:"US"

Search as if you’re in a specific country. Useful for location-specific content or regional variations.Use ISO Alpha-2 country codes like US, GB, FR, DE, CA, JP, etc.

locale

string

default:"en"

Set the language preference for your search results.Locale Examples:

en-US - English (United States)
en-GB - English (United Kingdom)
fr-FR - French (France)
de-DE - German (Germany)
es-ES - Spanish (Spain)
ja-JP - Japanese (Japan)

exclude_domains

array

Block specific websites from appearing in your results. Useful for filtering out social media, ads, or low-quality content.Maximum 50 domains per search.Example:

{
	"exlude_domains":[
		"https://www.example.com",
		"https://www.example.io"
	]
}

time_range

string

Only show recent results from a specific time period.Options: hour, day, week, month, year

start_date / end_date

start_date

string

Only show results published within a date range.Use format YYYY-MM-DD (like 2026-01-01) or just the year (2026).

Usage

Fast Mode search

Get search results without extracting full content (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",
    "num_results": 10,
    "deep_search": False
})

for item in result["results"]:
    print(f"{item['title']}: {item['url']}")

Deep Search with content extraction

Extract full content from search results (1 credit + 1 per page):

from nimble_python import Nimble

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

result = nimble.search({
    "query": "python web scraping tutorial",
    "num_results": 5,
    "deep_search": True,
    "parsing_type": "markdown"
})

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

Search with LLM answer

Get an AI-generated answer based on search results:

from nimble_python import Nimble

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

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

print("AI Answer:")
print(result["answer"])

print("\nSources:")
for item in result["results"]:
    print(f"- {item['title']}: {item['url']}")

Domain filtering

Exclude specific websites from results:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "web development tutorials",
    "num_results": 15,
    "exclude_domains": ["pinterest.com", "youtube.com"]
})

print(result)

Time-based filtering

Get only recent results:

from nimble_python import Nimble

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

# Results from last week
result = nimble.search({
    "query": "AI news",
    "num_results": 20,
    "time_range": "week"
})

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

print(result)

Localized search

Get results for specific countries and languages:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "beste Programmiersprache",
    "num_results": 10,
    "country": "DE",
    "locale": "de-DE"
})

print(result)

Combined parameters

Search with multiple parameters for precise control:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "machine learning tutorials",
    "num_results": 10,
    "deep_search": True,
    "parsing_type": "markdown",
    "focus": "coding",
    "time_range": "month",
    "country": "US",
    "exclude_domains": ["medium.com"]
})

print(f"Found {len(result['results'])} results")

Focus Modes

Focus 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 modes

Focus Mode	Description	Best For
`general` (default)	Web search engines (Google, Bing)	General information, broad topics, web pages
`news`	News sources (Google News)	Current events, breaking stories, journalism
`coding`	Developer resources and code	Code examples, debugging, API documentation
`academic`	Scholarly sources and papers	Scientific research, peer-reviewed studies
`shopping`	E-commerce platforms (Amazon, Walmart, Target)	Product comparison, pricing, merchant reviews
`social`	Social media (TikTok, LinkedIn, YouTube)	Social content, influencers, trending topics
`geo`	AI search engines (ChatGPT, Perplexity)	AI-generated answers, synthetic insights
`location`	Local business search (Google Maps)	Places, businesses, geographic information

News search

Find current events and breaking news:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "AI regulation updates",
    "focus": "news",
    "num_results": 10,
    "time_range": "week"
})

for item in result["results"]:
    print(f"{item['title']}: {item['url']}")

Coding search

Find programming resources and documentation:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "python async await best practices",
    "focus": "coding",
    "num_results": 10,
    "deep_search": True,
    "parsing_type": "markdown"
})

print(result)

Shopping search

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",
    "num_results": 20,
    "max_subagents": 5  # Search more platforms in parallel
})

print(result)

Find content from social platforms:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "machine learning tutorials",
    "focus": "social",
    "num_results": 15
})

print(result)

Academic search

Find scholarly papers and research:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "transformer architecture deep learning",
    "focus": "academic",
    "num_results": 10,
    "deep_search": True
})

print(result)

GEO (AI engines) search

Get results from AI search engines like ChatGPT and Perplexity:

from nimble_python import Nimble

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

result = nimble.search({
    "query": "how to optimize for AI search engines",
    "focus": "geo",
    "num_results": 10
})

print(result)

Choosing focus modes: Use news for current events, coding for technical docs, shopping for products, academic for research papers, social for trending content, and geo for AI-generated insights.

Response Fields

When you use Search, you receive:

Search results with context - Each result includes title, description, URL, and optionally full content
AI-generated answers - Optional LLM summary of findings when include_answer is enabled
Flexible formats - Choose markdown, plain text, or simplified HTML for extracted content
Rich metadata - Position, domain, and entity type for each result

Example Response

{
  "total_results": 5,
  "answer": "TypeScript offers several key benefits over JavaScript including static type checking, enhanced IDE support, and improved code quality...",
  "results": [
    {
      "title": "TypeScript vs JavaScript: Key Differences",
      "description": "Learn the main differences between TypeScript and JavaScript...",
      "url": "https://example.com/typescript-guide",
      "content": "# TypeScript vs JavaScript\n\nTypeScript is a typed superset...",
      "metadata": {
        "position": 1,
        "entity_type": "OrganicResult",
        "country": "US",
        "locale": "en"
      }
    }
  ],
  "request_id": "84f08ac1-bb5f-4b6f-8447-2d21cb930416"
}

Field	Type	Description
`total_results`	integer	Number of results returned
`answer`	string	AI-generated answer (when `include_answer` is true)
`results`	array	Search results
`results[].title`	string	Page title
`results[].description`	string	Page description/snippet
`results[].url`	string	Result URL
`results[].content`	string	Full page content (Deep Search only)
`results[].metadata.position`	integer	Position in search results
`request_id`	string	Unique identifier for the search request

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

Real-world examples

AI assistant with web search

Scenario: Your chatbot needs to answer questions with up-to-date information from the web.How Search helps:

Execute search with include_answer: true for instant AI summaries
Get source URLs for citation and transparency
Fast Mode keeps costs low for high-volume use
Optional Deep Search for detailed follow-up questions

Result: AI-powered Q&A with real-time web knowledge and source attribution.

Market research automation

Scenario: You need to research competitors, pricing, and market trends regularly.How Search helps:

Search for competitor mentions and product reviews
Use Deep Search to extract full article content
Filter by time range for recent developments
Exclude irrelevant domains to focus on quality sources

Result: Automated research workflows that deliver actionable insights.

Content aggregation

Scenario: Building a news feed or content database for a specific industry.How Search helps:

Use focus: "news" for news-specific results
Set time_range: "day" for latest content
Extract full articles with Deep Search
Parse to markdown for clean storage

Result: Automated content curation at scale.

SEO and visibility tracking

Scenario: Monitoring search rankings for your brand and keywords.How Search helps:

Track position changes over time
Monitor competitor visibility
Localized searches for different markets
Domain filtering to focus on specific competitors

Result: Search visibility insights without manual SERP checking.

Search vs other tools

Need	Use
Search web + extract content from results	Search
Data from popular sites (Amazon, Google, etc.)	Public Agent - maintained by Nimble
Data from sites not in the gallery	Custom Agent - create with natural language
Data from specific URLs	Extract
URLs with context for AI planning	Map
Data from entire website	Crawl

Choose the right mode - Use Fast Mode (deep_search: false) for URL discovery and quick answers. Use Deep Search (default) when you need full page content.

Introduction

Web Tools

Agentic

Quick Start

Example Request

Example Response

How it works

Parameters

Usage

Fast Mode search

Deep Search with content extraction

Search with LLM answer

Domain filtering

Time-based filtering

Localized search

Combined parameters

Focus Modes

Available modes

News search

Coding search

Shopping search

Academic search

GEO (AI engines) search

Response Fields

Use cases

Research & Data Collection

AI Agent Tasks

Content Monitoring

Competitive Intelligence

Real-world examples

Search vs other tools

Next steps

Web Search Skill

LangChain Integration

Introduction

Web Tools

Agentic

​Quick Start

​Example Request

​Example Response

​How it works

​Parameters

​Usage

​Fast Mode search

​Deep Search with content extraction

​Search with LLM answer

​Domain filtering

​Time-based filtering

​Localized search

​Combined parameters

​Focus Modes

​Available modes

​News search

​Coding search

​Shopping search

​Social media search

​Academic search

​GEO (AI engines) search

​Response Fields

​Use cases

Research & Data Collection

AI Agent Tasks

Content Monitoring

Competitive Intelligence

​Real-world examples

​Search vs other tools

​Next steps

Web Search Skill

LangChain Integration

Quick Start

Example Request

Example Response

How it works

Parameters

Usage

Fast Mode search

Deep Search with content extraction

Search with LLM answer

Domain filtering

Time-based filtering

Localized search

Combined parameters

Focus Modes

Available modes

News search

Coding search

Shopping search

Social media search

Academic search

GEO (AI engines) search

Response Fields

Use cases

Real-world examples

Search vs other tools

Next steps