---
title: "Search"
method: POST
path: "/v2/search"
tags: ["Search"]
---

# Search

`POST /v2/search`

## Request body

- SearchRequest — Request body model for the /search endpoint.
  - `content_type` string[], nullable — Filter by content type (only supported with focus=general). Supports semantic groups ('documents', 'spreadsheets', 'presentations') and specific formats ('pdf', 'docx', 'xlsx', etc.)
  - `country` string — Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
  - `deep_search` boolean, nullable — Deprecated. Use search_depth instead. true maps to 'deep', false maps to 'lite'.
  - `end_date` string, nullable — Filter results before this date (format: YYYY-MM-DD or YYYY)
  - `exclude_domains` string[], nullable — List of domains to exclude from search results. Maximum 50 domains.
  - `focus` union — Search focus mode (e.g., 'general', 'news', 'shopping') or a list of explicit subagent names (e.g., ['amazon_serp', 'target_serp'])
    - string
    - string[]
  - `full_content` boolean — Return richer per-result content on the fast path. With search_depth='fast', enables live crawling of both web and news sources so results carry full markdown content instead of snippets only. Higher recall and cost. Ignored for other search_depth values.
  - `include_answer` boolean — Generate an LLM-powered answer summary based on search result snippets.
  - `include_domains` string[], nullable — List of domains to include in search results. Maximum 50 domains.
  - `locale` string — Language/locale code (e.g., 'en', 'fr', 'de')
  - `max_results` integer — Maximum number of results to return. Actual count may be lower depending on availability.
  - `max_subagents` integer — Maximum number of subagents to execute in parallel for WSA focus modes (shopping, social, geo). Ignored for SERP focus modes.
  - `output_format` 'plain_text' | 'markdown' | 'simplified_html' — Enum representing the parsing types supported by Nimble
  - `query` string, required — Search query string
  - `search_depth` 'lite' | 'fast' | 'deep' — Controls content richness and latency of search results. - lite: Token-efficient metadata for high-volume pipelines (title, URL, description only) - fast: Rich content (~2K chars) optimized for AI agents - deep: Full page content via Webit scraping for comprehensive analysis
  - `start_date` string, nullable — Filter results after this date (format: YYYY-MM-DD or YYYY)
  - `time_range` 'hour' | 'day' | 'week' | 'month' | 'year' — Time range filters passed to Webit SERP API as 'time' parameter.

## Response `200`

Successful Response

- SearchResponse — Response model from SearchService with results and optional LLM answer. Note: request_id is always a valid UUID generated internally by the middleware, so no validation is needed.
  - `answer` string, nullable
  - `answer_citations` Citation[], nullable — Citations mapping citation markers to result indices
    - `marker` integer, required — Citation marker number (e.g., 1 for [1])
    - `result_index` integer, required — Zero-based index into the results array
  - `request_id` string, required — Unique identifier for this request (UUID)
  - `results` ResultModel[], required
    - `additional_data` object, nullable — Platform-specific fields (e.g., price, rating, publish_date). Omitted from response when no extra data.
    - `content` string, required
    - `description` string, required
    - `metadata` union, required
      - SERPMetadata — Metadata for SERP-based search results (general, news, location).
        - `country` string, required
        - `driver` string, nullable
        - `entity_type` string, required
        - `locale` string, required
        - `position` integer, required
      - WSAMetadata — Metadata for WSA-based search results.
        - `agent_name` string, required
    - `title` string, required
    - `url` string, required
  - `serp_data` object, nullable — Cleaned SERP entities (e.g. KnowledgeGraph, TopStory, RelatedSearch). Only present for focus='serp'.
  - `total_results` integer, required — Number of results returned

---

[API](https://skmtc.net/nimbleway/apis/api-gateway.md) · [All operations](https://skmtc.net/nimbleway/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nimbleway/api-gateway/revisions/9bfe220b7a29/schema)