---
title: "Run a live websearch."
method: GET
path: "/v1/chat/websearch"
tags: ["websearch"]
---

# Run a live websearch.

`GET /v1/chat/websearch`

Run a live websearch on a set of queries, get back a fully structured and
LLM-distilled response (in addition to the raw text if you need that as well).

Your response includes as_string and as_dicts, where as_string is a prompt-optimized
distillation of the information, done by an LLM. as_dicts contains all the details
necessary to feed into other parts of your application.

## Query parameters

- `queries` string[], required — A list of queries to be live searched, analyzed, distilled, and structured.
- `lookback` integer, nullable — Number of hours back to allow the websearch to look. Defaults to All time
- `start_datetime` string, date-time, nullable — Earliest acceptable publication datetime for results. For v1, acts like the existing lookback filter.
- `end_datetime` string, date-time, nullable — Latest acceptable publication datetime for results.
- `engine` 'v1' | 'v1.5' — Search engine version to use for live websearch results.
- `domains` string[], nullable — A list of domains to search.
- `strict` boolean — If true, the websearch will only return results that have a known publication date and are within the lookback period.
- `offset` union — The number of results to offset for followup queries. Numeric for regular websearch; X (Twitter) searches return an opaque cursor string in response.offset — pass it back here to paginate.
  - integer
  - string

## Response `200`

Structured websearch.

- WebSearchResponse
  - `as_string` string, required
  - `as_dicts` WebSearchResult[], required
    - `title` string, required
    - `url` string, uri, required
    - `source` string, required
    - `published` string, required
    - `key_points` string[], required
    - `raw_text` string
    - `as_string_key` string, nullable
  - `offset` union
    - integer
    - string

## Other responses

- `422` — Validation Error

---

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