---
title: "Look up public Spotlights or documentation with a bounded English query."
method: GET
path: "/ask"
---

# Look up public Spotlights or documentation with a bounded English query.

`GET /ask`

## Request

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

Deterministic read-only retrieval, not generated advice. No account access, bidding, payments or conversational state.

## Query parameters

- `query` string, required
- `mode` 'list'
- `streaming` boolean

## Response `200`

Bounded public retrieval. Streaming returns start, indexed result and complete SSE events, then closes.

- object
  - `_meta` object, required
    - `version` '0.55', required
    - `response_type` 'answer', required
    - `response_format` 'conversational_search', required
  - `results` object[], required
    - `@type` 'CreativeWork'
    - `url` string, uri
    - `name` string
    - `text` string
    - `description` string
    - `datePublished` string, date
    - `additionalType` string

## Other responses

- `400`: Invalid request, byte limit exceeded, or unavailable public content. Errors remain JSON even when streaming was requested.
- `404`: Invalid request, byte limit exceeded, or unavailable public content. Errors remain JSON even when streaming was requested.
- `413`: Invalid request, byte limit exceeded, or unavailable public content. Errors remain JSON even when streaming was requested.
- `429`: Shared public token bucket exhausted. Wait Retry-After seconds before retrying.
- `503`: Invalid request, byte limit exceeded, or unavailable public content. Errors remain JSON even when streaming was requested.

---

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