---
title: "Retrieve published website evidence"
method: GET
path: "/ask"
---

# Retrieve published website evidence

`GET /ask`

## Request

- Base URL: `https://appsflyer.com`
- URL: `https://appsflyer.com/ask`
- Auth: none required
- TypeScript: <https://skmtc.dev/appsflyer/apis/appsflyer-com-api/docs/ask/get.ts> (a function with typed inputs; its response is checked against the schema)

Ora GET convenience adapter for NLWeb list retrieval. Use POST for the canonical envelope and context. JSON is the default.

## Query parameters

- `query` string, required
- `site` string: Consistency assertion against the authenticated website.
- `mode` string
- `streaming` boolean
- `limit` integer
- `query_id` string

## Response `200`

NLWeb answer with retrieved evidence and source provenance, or application failure.

- union
  - object
    - `_meta` object, required
      - `version` '0.55', required
      - `request_id` string
      - `response_type` 'answer', required
      - `response_format` 'conversational_search', required
      - `release` object, required
        - `id` string, required
    - `results` object[], required
      - `@type` 'WebPage', required
      - `url` string, uri, required
      - `name` string, required
      - `site` string, required
      - `score` number, required
      - `description` string, required
      - `grounding` object, required
        - `evidence` object[], required
          - `id` string, required
          - `documentId` string, required
          - `url` string, uri, required
          - `text` string, required
          - `start` integer, required
          - `end` integer, required
          - `view` 'origin' | 'published', required
          - `context` object
            - `profile` 'adjacent-passages-v1', required
            - `anchorStart` integer, required
            - `anchorEnd` integer, required
            - `passageIds` string[], required
  - object
    - `_meta` object, required
      - `version` '0.55', required
      - `request_id` string
      - `response_type` 'failure', required
    - `error` object, required
      - `code` string, required
      - `message` string, required
      - `status` integer
      - `retry_after` number

## Other responses

- `400`: Malformed NLWeb request.
- `403`: Request Origin is not this website.
- `404`: Domain querying is disabled or no eligible publication exists.
- `406`: Accept does not allow the requested response transport.
- `429`: Shared query allowance exhausted.
- `503`: Query service or admission unavailable.
- `504`: Query deadline exceeded.

---

[API](https://skmtc.dev/appsflyer/apis/appsflyer-com-api.md) - [All operations](https://skmtc.dev/appsflyer/apis/appsflyer-com-api/llms.txt) - [OpenAPI document](https://skmtc.dev/appsflyer/apis/appsflyer-com-api/revisions/42ea5bcdd76e?raw)