NInimbleway
Search

Search

Changed on
post/v2/search

Request

  • Base URL
    https://sdk.nimbleway.com
  • URL
    https://sdk.nimbleway.com/v2/search
  • Auth
    HTTP bearer

Request body

querystring required

Search query string

search_depth'lite' | 'standard'

Controls content richness and latency of search results.

  • lite: Token-efficient metadata for high-volume pipelines (title, URL, description only)
  • standard: Rich content (~2K chars) optimized for AI agents
full_contentboolean

Return full page content for each result, in addition to its title, url, and description. Works with either search_depth value. Higher recall and cost.

safe_search'off' | 'moderate' | 'strict'

Toxic-content filtering level. Omitting it in a request is not the same as sending 'off'.

content_typestring[] nullable

Filter by content type (only supported with focus=general). Supports semantic groups ('documents', 'spreadsheets', 'presentations') and specific formats ('pdf', 'docx', 'xlsx', etc.)

countrystring

Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')

end_datestring nullable

Filter results before this date (format: YYYY-MM-DD or YYYY)

exclude_domainsstring[] nullable

List of domains to exclude from search results. Maximum 50 domains.

include_domainsstring[] nullable

List of domains to include in search results. Maximum 50 domains.

localestring

Language/locale code (e.g., 'en', 'fr', 'de')

max_resultsinteger

Maximum number of results to return. Actual count may be lower depending on availability.

output_format'plain_text' | 'markdown' | 'simplified_html'

Enum representing the parsing types supported by Nimble

start_datestring 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

Successful Response

request_idstring required

Unique identifier for this request (UUID)

safe_search'off' | 'moderate' | 'strict'

Toxic-content filtering level. Omitting it in a request is not the same as sending 'off'.

total_resultsinteger required

Number of results returned

Changes

  • 75720b84c9d7Revision changes
    • breaking

      removed the enum value deep of the request property /

    • breaking

      removed the enum value fast of the request property /

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the optional property from the response with the status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new standard enum value to the request property /

    • info

      added the optional property to the response with the status