---
title: "Search, payment required (x402 or MPP)"
method: POST
path: "/v1/paid/search"
---

# Search, payment required (x402 or MPP)

`POST /v1/paid/search`

## Request

- Base URL: `https://search.neurobird.com`
- URL: `https://search.neurobird.com/v1/paid/search`
- Auth: HTTP bearer

The same search, but always priced.

`/search` keeps a free demo lane, which means it answers 200 to an
unauthenticated caller and is therefore not a payment-required resource in
the protocol sense. This route always issues a challenge, so agents and the
MPP and x402 registries have an endpoint whose terms are unambiguous.

Both protocols are offered on the same 402: an MPP challenge in
`WWW-Authenticate: Payment` and an x402 challenge in `PAYMENT-REQUIRED`.

## 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

- unknown

## Other responses

- `402`: Payment required. The response carries an MPP challenge in `WWW-Authenticate: Payment` and an x402 challenge in the base64 `PAYMENT-REQUIRED` header. Pay with either and retry: MPP credentials go in `Authorization: Payment`, x402 payloads in `PAYMENT-SIGNATURE`. Both settle through the same x402 facilitator.
- `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)