---
title: "List prompt suggestions"
method: GET
path: "/api/sites/multiscreen/{site_name}/aeo/prompts/suggestions"
tags: ["AEO Prompts"]
---

# List prompt suggestions

`GET /api/sites/multiscreen/{site_name}/aeo/prompts/suggestions`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/{site_name}/aeo/prompts/suggestions`
- Auth: HTTP basic

Returns suggested prompts for the site with their estimated search volume, highest volume first. The list isn't paged.

To track a suggestion, send its `text` to Add prompts. Suggestions can include texts the site already tracks; adding one of those returns `400 AeoPromptDuplicate`.

## Path parameters

- `site_name` string, required

## Response `200`

OK

- PageResponseApiAeoPromptSuggestionResp
  - `limit` integer: Page size applied for request
  - `offset` integer: Offset applied for request
  - `results` ApiAeoPromptSuggestionResp[]: Content payload
    - `text` string: The suggested question.
    - `volume` integer: Estimated search volume for the prompt.
  - `site_name` string: Owning site
  - `total_responses` integer: Total amount of elements matching requested filters

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `403`: Forbidden. `error_code` is `AccessForbidden`, and `errors[0].code` names the cause: - No code (`errors` is empty): the caller can't access the site. - `AeoPlanNotFound`: the account has no active AEO plan.
- `404`: Not found. `error_code` is `ResourceNotExist`, and `errors[0].code` names the cause: - `AeoProjectNotFound`: the site has no AEO project.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)