---
title: "Search the web"
method: POST
path: "/v1/search"
---

# Search the web

`POST /v1/search`

## Request

- Base URL: `https://search.neurobird.com`
- URL: `https://search.neurobird.com/v1/search`
- Auth: none required

Search the live web and get ranked results with the relevant passages already extracted from each page, so a follow up fetch is usually unnecessary.

Use `search_depth: "basic"` for a quick lookup (1 credit), `"standard"` to open and read the top pages (1 credit), or `"advanced"` to also expand the query and read more pages (2 credits). Set `include_answer: true` (+1 credit) for a grounded summary, and `verify_quotes: true` to have every supporting quote checked against its source text and returned marked verified or not.

Accepts the same fields as Tavily's search endpoint. Also accepts `schema`, a JSON Schema filled from each result, and returns per stage `timings`.

Can be paid per call with x402 instead of a key: send an `Accept` containing `payment-required`, or `?x402=1`, to receive a 402 challenge.

## Request body

- SearchRequest
  - `query` string, required
  - `search_depth` 'basic' | 'standard' | 'advanced'
  - `topic` 'general' | 'news' | 'code' | 'science' | 'finance'
  - `max_results` integer
  - `days` integer, nullable
  - `time_range` string, nullable
  - `include_domains` string[]
  - `exclude_domains` string[]
  - `country` string, nullable
  - `language` string, nullable
  - `include_answer` union
    - boolean
    - 'basic' | 'advanced'
  - `include_raw_content` union
    - boolean
    - 'markdown' | 'text'
  - `include_images` boolean
  - `verify_quotes` boolean
  - `schema` object, nullable
  - `expand_query` boolean, nullable
  - `chunks_per_source` integer

## Response `200`

Successful Response

- SearchResponse
  - `query` string, required
  - `answer` string, nullable
  - `results` SearchResult[], required
    - `title` string, required
    - `url` string, required
    - `content` string, required
    - `score` number, required
    - `raw_content` string, nullable
    - `published_date` string, nullable
    - `engines` string[]
    - `domain` string
    - `extracted` boolean
    - `structured` object, nullable
  - `images` object[]
  - `response_time` number, required
  - `request_id` string, required
  - `quotes` Quote[]
    - `text` string, required
    - `url` string, required
    - `verified` boolean, required
  - `sub_queries` string[]
  - `credits` integer
  - `depth` string
  - `timings` object
  - `cached` boolean
  - `provider` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/neurobird/apis/neurobird-search-api.md) · [All operations](https://skmtc.dev/neurobird/apis/neurobird-search-api/llms.txt) · [OpenAPI document](https://skmtc.dev/neurobird/apis/neurobird-search-api/revisions/103dcd55a8f5?raw)