---
title: "NLWeb-style creator catalog answer search"
method: GET
path: "/public/creators/{slug}/ask"
---

# NLWeb-style creator catalog answer search

`GET /public/creators/{slug}/ask`

## Request

- Base URL: `https://api.agentcdn.com`
- URL: `https://api.agentcdn.com/public/creators/{slug}/ask`
- Auth: none declared

Schema.org ItemList of matching moments. Results carry watch URLs anchored with `t=`; no stream URL is ever returned here.

## Path parameters

- `slug` string, required

## Query parameters

- `q` string, required

## Response `200`

Schema.org ItemList of matching video moments.

- NlwebSearchResponse
  - `@context` 'https://schema.org', required
  - `@type` 'ItemList', required
  - `name` string, required
  - `itemListElement` object[], required
    - `@type` 'ListItem', required
    - `position` integer, required
    - `relevanceScore` number, required
    - `matchField` 'transcript' | 'on_screen_text' | 'shot_caption' | 'chapter_summary'
    - `item` object, required
      - `@type` 'VideoObject', required
      - `@id` string, uri, required
      - `name` string, required
      - `description` string, required
      - `url` string, uri
      - `thumbnailUrl` string, uri
      - `uploadDate` string
      - `duration` string, required
      - `creator` object, required
        - `@type` 'Person', required
        - `name` string, required
        - `url` string, uri
      - `potentialAction` object, required
        - `@type` 'WatchAction', required
        - `target` string, uri, required
        - `startOffset` number, required
        - `endOffset` number
  - `no_answer` object
    - `reason` 'not_covered' | 'not_direct' | 'out_of_range' | 'unavailable' | 'blocked_topic' | 'not_approved' | 'urgent_help' | 'not_ready', required
    - `scope` 'library' | 'video', required
    - `text` string, required

## Other responses

- `400`: Missing slug or empty q. Error codes: creator_slug_required, query_required.
- `404`: Unknown, private, or retired creator. Error codes: creator_not_found.
- `429`: Rate limited. Retry after the retry-after header (seconds). Error codes: agent_rate_limited.

---

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