---
title: "NLWeb-compatible natural-language query endpoint (POST)"
method: POST
path: "/ask"
tags: ["NLWeb"]
---

# NLWeb-compatible natural-language query endpoint (POST)

`POST /ask`

## Request

- Base URL: `https://www.snowsure.ai`
- URL: `https://www.snowsure.ai/ask`
- Auth: none declared

## Request body

- object
  - `query` string, required
  - `site` string
  - `prev` string
  - `query_id` string
  - `mode` 'list' | 'summarize' | 'generate'
  - `streaming` string

## Response `200`

NLWeb response (JSON, or text/event-stream when streaming)

- NlwebResponse
  - `query_id` string
  - `results` object[]
    - `url` string, uri
    - `name` string
    - `site` string
    - `score` number
    - `description` string
    - `schema_object` object

## Other responses

- `400`: query is required
- `429`: Rate limit exceeded

---

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