---
title: "Natural-language query (NLWeb)"
method: POST
path: "/ask"
tags: ["discovery"]
---

# Natural-language query (NLWeb)

`POST /ask`

## Request

- Base URL: `https://aicontentdrop.com`
- URL: `https://aicontentdrop.com/ask`
- Auth: none required

Ask a natural-language question about the model catalogue or our published guides and get Schema.org-shaped JSON results. Implements the NLWeb /ask convention (github.com/microsoft/NLWeb). Read-only, no API key, keyword-routed (no LLM call), 60 requests/minute. Use it for discovery; use POST /v1/generate/video to actually generate. Set `prefer.streaming: true` (or send `Accept: text/event-stream`) for an SSE response with `start`, `result`, and `complete` events.

## Request body

- object
  - `query` string, required: The question, in natural language

## Response `200`

Ranked results

- object
  - `_meta` object, required
    - `response_type` 'model_catalogue' | 'articles', required: Which answer set the query was routed to
    - `version` string, required: NLWeb contract version
    - `site` string
    - `protocol` string
    - `documentation` string, uri
  - `query` string, required
  - `results` object[], required
    - `url` string, uri, required
    - `name` string, required
    - `site` string, required
    - `score` number, required: Relevance, 0-100
    - `description` string, required
    - `schema_object` object: Schema.org representation of the item
  - `capabilities` object

## Other responses

- `400`: The query was missing or unusable.
- `429`: Rate limited. Read Retry-After (header) or error.retry_after_seconds (body) — they carry the same number — and wait that long. Retrying sooner extends the window rather than shortening it.
- `500`: Unexpected failure on our side. Retry once; nothing was charged.

---

[API](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api.md) · [All operations](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicontentdrop/apis/ai-content-drop-api/revisions/75a13a8043ae?raw)