---
title: "NLWeb-shaped catalog ask"
method: GET
path: "/ask"
tags: ["discovery"]
---

# NLWeb-shaped catalog ask

`GET /ask`

## Request

- Base URL: `https://skillselion.com`
- URL: `https://skillselion.com/ask`
- Auth: none declared

GET /ask?query= (also q / question) returns a schema.org ItemList. SSE when Accept: text/event-stream or ?stream=1. Browser document navigation 302s to /browse. Accept: text/html without Sec-Fetch navigate still returns JSON.

## Query parameters

- `query` string
- `q` string
- `question` string
- `stream` '1'

## Response `200`

schema.org ItemList, or SSE when streaming.

- AskResult
  - `@type` 'ItemList', required
  - `name` string
  - `query` string
  - `numberOfItems` integer
  - `itemListElement` object[], required
  - `_meta` object, required
    - `response_type` 'item_list', required
    - `version` string, required
    - `site` string, uri

---

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