---
title: "Natural-language query (NLWeb, query-string form)"
method: GET
path: "/ask"
tags: ["discovery"]
---

# Natural-language query (NLWeb, query-string form)

`GET /ask`

## Request

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

Identical to POST /ask, with the question supplied as the `query` query-string parameter. Provided because some agent HTTP clients cannot send a request body on a discovery call.

## Query parameters

- `query` string, required

## 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)