---
title: "Web Search"
method: POST
path: "/global/web-search/v1"
tags: ["Global", "Croma"]
---

# Web Search

`POST /global/web-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/global/web-search/v1`
- Auth: HTTP bearer

AI-powered web search. Returns structured results with URLs, titles, authors, dates, highlights, and relevance scores.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string, required: Natural-language search query.
  - `limit` integer: Number of results to return.

## Response `200`

Successful response

- WebSearchResponse
  - `data` object, required
    - `results` object[], required
      - `url` string, uri, required
      - `title` string, nullable, required
      - `publication_date` string, date-time, nullable, required
      - `author` string, nullable, required
      - `highlights` string[], required
      - `score` number, nullable, required

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)