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

# /search

`POST /v1/search`

The `/search` endpoint allows you to retrieve web content.

## Request body

- SearchInput
  - `excludeDomains` string[] — The domains you want to exclude of the search. By default, don't restrict the search.
  - `fromDate` string, nullable — The date from which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be before `toDate`, if provided, and later than 1970-01-01.
  - `includeDomains` string[] — The domains you want to search on. By default, don't restrict the search. You can provide up to 100 domains.
  - `q` string, required — The natural language question for which you want to retrieve context.
  - `structuredOutputSchema` unknown
  - `toDate` string, nullable — The date until which the search results should be considered, in ISO 8601 format (YYYY-MM-DD). It must be later than `fromDate`, if provided, or than 1970-01-01.
  - `depth` 'deep' | 'fast' | 'standard', required — Defines the precision of the search. [BETA] `fast` is a sub-second search mode optimized for simple, focused queries; `standard` leverages agentic search to handle broader queries spanning multiple topics or sources, while remaining fast; `deep` leverages several iterations of agentic search to return comprehensive results, optimizing for coverage.
  - `includeImages` union — Defines whether the API should include images in its results.
    - boolean
    - string
  - `includeInlineCitations` union — Relevant only when `outputType` is `sourcedAnswer`. Defines whether the answer should include inline citations.
    - boolean
    - string
  - `includeSources` union — Relevant only when `outputType` is `structured`. Defines whether the response should include sources. **Please note that it modifies the schema of the response, see below**
    - boolean
    - string
  - `maxResults` number — The maximum number of results to return. The number of results will always be ≤ to maxResults.
  - `outputType` 'searchResults' | 'sourcedAnswer' | 'structured', required — The type of output you want to get. Use `structured` for a custom-formatted response defined by `structuredOutputSchema`.

## Response `200`

Successful response

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `402` — Payment Required - No API key provided. Returns x402 payment details in the `payment-required` header for pay-per-request with USDC.
- `429` — Too Many Requests - Rate limit exceeded or insufficient credits

---

[API](https://skmtc.dev/linkup/apis/linkup-api.md) · [All operations](https://skmtc.dev/linkup/apis/linkup-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/linkup/linkup-api/revisions/1e5050ee899a/schema)