---
title: "Pages worth recording"
method: GET
path: "/v1/projects/{projectId}/page-suggestions"
tags: ["Settings changes"]
---

# Pages worth recording

`GET /v1/projects/{projectId}/page-suggestions`

## Request

- Base URL: `https://hootlens-api-368877148687.us-east1.run.app`
- URL: `https://hootlens-api-368877148687.us-east1.run.app/v1/projects/{projectId}/page-suggestions`
- Auth: HTTP bearer

Pages visitors reached by link from recorded pages that no page targeting rule records, read from the link targets in recent replays (none are kept under the strict preset). Each suggestion has the change that starts recording it.

Required token scopes are listed in x-hootlens-scopes. A signed-in person needs the matching permission on the site instead (the viewer and editor roles are presets of the permissions).

## Path parameters

- `projectId` string, required: An identifier: 1 to 80 letters, digits, underscores or hyphens.

## Response `200`

The suggestions.

- PageSuggestions
  - `suggestions` object[], required
    - `path` string, required
    - `clicks` integer, required
    - `visits` integer, required
    - `from` string[], required
    - `reason` 'excluded' | 'not-included', required
    - `rule` string
    - `change` object, required
  - `recordings` object, required
    - `read` integer, required
    - `withLinks` integer, required
  - `note` string

## Other responses

- `401`: The credential is missing, expired or revoked.
- `403`: The credential or the person's permissions on the site do not permit this action.
- `404`: The site, or the record inside it, does not exist or the caller is not a member (a non-member cannot tell the two apart).
- `429`: A rate limit or a per-site limit was reached.

---

[API](https://skmtc.dev/hootlens/apis/hoot-lens-api.md) · [All operations](https://skmtc.dev/hootlens/apis/hoot-lens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hootlens/apis/hoot-lens-api/revisions/f64f8dc7b84e?raw)