---
title: "The latest individual answers"
method: GET
path: "/brands/{brandId}/answers"
tags: ["measurement"]
---

# The latest individual answers

`GET /brands/{brandId}/answers`

## Request

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

Newest first: the prompt, the engine, whether the brand was named and at
what rank, the competitors named and the pages cited. Evidence, not a
metric. Do not derive a rate from it: `visibility` withholds numbers below
ten answers, and a count of these would not.

To read the answers behind a finding on a prompt, pass its `subjectRef`
as `promptGroupId`.

## Query parameters

- `limit` integer
- `promptGroupId` string
- `engine` 'google_aio' | 'google_ai_mode' | 'chatgpt': `google_aio` — Google AI Overviews. `google_ai_mode` — Google AI Mode, tracked since 2026-10-15. `chatgpt` — ChatGPT.

## Response `200`

Answers, newest first.

- object
  - `answers` Answer[], required
    - `runId` string, required
    - `promptGroupId` string, required
    - `prompt` string, required
    - `engine` 'google_aio' | 'google_ai_mode' | 'chatgpt', required: `google_aio` — Google AI Overviews. `google_ai_mode` — Google AI Mode, tracked since 2026-10-15. `chatgpt` — ChatGPT.
    - `state` 'succeeded' | 'empty', required: `empty`: the engine gave no AI answer for the prompt. An observation, not a failure.
    - `executedAt` string, date-time, required
    - `mentioned` boolean, required
    - `rank` integer, nullable, required: Order of first appearance among the tracked names, 1-based, when mentioned.
    - `context` string, nullable, required: About 200 characters either side of the brand's first mention.
    - `competitors` object[], required
      - `entityId` string, required
      - `name` string, required
      - `rank` integer, required
    - `citations` object[], required
      - `url` string, required
      - `domain` string, required
      - `title` string, nullable, required
      - `isSelf` boolean, required

## 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)