---
title: "Execute Web Search Lite"
method: POST
path: "/web-search/search-lite"
tags: ["public"]
---

# Execute Web Search Lite

`POST /web-search/search-lite`

Lightweight search-only endpoint. Returns search snippets and URLs without
fetching page contents. Pair with `/open-urls` if you need to fetch content
later.

## Request body

- WebSearchToolRequest
  - `queries` string[], required — List of search queries to send to the configured provider.
  - `max_results` integer, nullable — Optional cap on number of results to return per query. Defaults to 10.

## Response `200`

Successful Response

- WebSearchToolResponse
  - `results` LlmWebSearchResult[], required
    - `document_citation_number` integer, required
    - `unique_identifier_to_strip_away` string, nullable
    - `type` 'web_search'
    - `url` string, required
    - `title` string, required
    - `snippet` string, required
  - `provider_type` 'google_pse' | 'serper' | 'exa' | 'searxng', required

## Other responses

- `422` — Validation Error

## Changes

- **2026-01-06** `2d941ea53eb3` — 1 info
  - endpoint added
- **2025-08-21** `9321c45d93b5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/onyx-dot-app/apis/onyx-api/changes/web-search/search-lite/post.md)

---

[API](https://skmtc.dev/onyx-dot-app/apis/onyx-api.md) · [All operations](https://skmtc.dev/onyx-dot-app/apis/onyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onyx-dot-app/onyx-api/revisions/2980a9073ffe/schema)