---
title: "Names the answers use that you do not track"
method: GET
path: "/brands/{brandId}/suggestions"
tags: ["entities"]
---

# Names the answers use that you do not track

`GET /brands/{brandId}/suggestions`

## Request

- Base URL: `https://shruwd.io/api/v1`
- URL: `https://shruwd.io/api/v1/brands/{brandId}/suggestions`
- Auth: HTTP bearer

The discovery pass: capitalised names found in the AI answers that match
none of the brand's aliases, surfaced when they appear in at least 20% of
a prompt cluster's responses. Each carries that share so the reason it is
here is visible. Accept one to make it a competitor (it then counts in
share of voice); dismiss one to quiet it for ninety days.

## Query parameters

- `state` 'open' | 'accepted' | 'dismissed' | 'all'

## Response `200`

Suggestions, strongest first.

- object
  - `suggestions` Suggestion[], required
    - `suggestionId` string, required
    - `brandId` string, required
    - `name` string, required: The most frequent surface form in the answers.
    - `domainHint` string, nullable, required: The registrable domain of the name's own site, when the answers linked the name to it. A link to someone else's page is a citation, not the name's site, and gives no hint. Used as the entity's domain on acceptance unless overridden.
    - `state` 'open' | 'accepted' | 'dismissed', required
    - `share` number, required: Distinct responses in the cluster that named it, divided by the cluster's responses. In [0, 1].
    - `responses` integer, required
    - `clusterResponses` integer, required
    - `cluster` string, required: `*` for the whole prompt set, otherwise a prompt tag.
    - `samplePromptGroupId` string, nullable, required: One prompt whose answers named it.
    - `firstSeenAt` string, date-time, required
    - `lastSeenAt` string, date-time, required
    - `decidedAt` string, date-time, nullable, required
    - `entityId` string, nullable, required: The competitor it became, once accepted.

## Other responses

- `404`: `not_found`: no such resource in this workspace.
- `default`: Every failure has this body.

---

[API](https://skmtc.dev/shruwd/apis/shruwd-api.md) · [All operations](https://skmtc.dev/shruwd/apis/shruwd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shruwd/apis/shruwd-api/revisions/64a5da079928?raw)