---
title: "List prompt suggestions"
method: GET
path: "/v1/projects/{projectId}/geo/prompts/suggestions"
tags: ["GEO"]
---

# List prompt suggestions

`GET /v1/projects/{projectId}/geo/prompts/suggestions`

## Request

- Base URL: `https://api.usenotra.com`
- URL: `https://api.usenotra.com/v1/projects/{projectId}/geo/prompts/suggestions`
- Auth: HTTP bearer

Pending prompts Notra suggests tracking, derived from the project's Google Search Console queries. Empty until Search Console is connected and synced in the dashboard.

## Path parameters

- `projectId` string, required

## Response `200`

Prompt suggestions fetched successfully

- ListGeoPromptSuggestionsResponse
  - `suggestions` GeoPromptSuggestion[], required
    - `id` string, required
    - `prompt` string, required
    - `title` string, nullable, required
    - `source` 'search_console', required
    - `keywords` object[], required: Search Console queries the suggestion was derived from.
      - `query` string, required
      - `clicks` number, required
      - `impressions` number, required
      - `position` number, required
    - `createdAt` string, required
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `402`: GEO plan or available AI credits required
- `403`: Forbidden
- `404`: Organization, project or resource not found
- `409`: Conflict
- `500`: Internal server error
- `503`: Authentication or billing service unavailable

## Changes

- **2026-10-28** `5d236d77f14c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/projects/:projectId/geo/prompts/suggestions/get.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) - [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/bddf95783469?raw)