---
title: "Web Search"
method: POST
path: "/v1/search"
---

# Web Search

`POST /v1/search`

Perform a web search and return structured results.

## Request body

- object
  - `query` string, required — The search query string
  - `numResults` integer — Number of results to return (1-25)

## Response `200`

The request has succeeded.

- object
  - `requestId` string, required — Unique identifier for the request
  - `query` string, required — The search query that was executed
  - `results` object[], required — List of search results
    - `id` string, required — Unique identifier for the result
    - `url` string, required — The URL of the search result
    - `title` string, required — The title of the search result
    - `author` string — Author of the content if available
    - `publishedDate` string, date-time — Publication date in ISO 8601 format
    - `image` string — Image URL if available
    - `favicon` string — Favicon URL

## Changes

- **2026-03-16** `9b1e2a2abf39` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/search/post.md)

---

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