---
title: "Latest raw answers"
method: GET
path: "/org/analytics/answers/latest"
tags: ["Analytics"]
---

# Latest raw answers

`GET /org/analytics/answers/latest`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/analytics/answers/latest`
- Auth: API key in header `X-API-Key`

The most recent stored answer per prompt × model × location, with full response text, citations, and competitor mentions. There is no date window — this is a snapshot of the newest answer of each combination by construction, so `from`/`to` filter on each answer's collection time and hide combinations whose latest answer falls outside the range rather than returning older ones. Paged. Requires the GEO product.

## Query parameters

- `models` string
- `location` string
- `prompt_type` 'awareness' | 'consideration' | 'evaluation' | 'decision'
- `tag` string
- `from` string, date
- `to` string, date
- `mentioned` boolean
- `cited` boolean
- `citation_tier` 'primary' | 'tracked' | 'secondary': A cited URL's classification tier — `primary` (Owned: one of your own websites), `tracked` (Tracked: one of your configured tracked sources), or `secondary` (External: any other domain). The tiers partition citations, so every cited URL falls in exactly one of them.
- `limit` integer
- `offset` integer

## Response `200`

The paged latest-answer feed.

- OrgLatestAnswersResponse: The paged latest-answer feed. No date window by construction.
  - `total` integer, required: Total answers matching the filter, across all pages.
  - `limit` integer, required: The page size that was applied.
  - `offset` integer, required: The row offset that was applied.
  - `answers` LatestAnswerItem[], required
    - `prompt_id` string, required: The prompt's id.
    - `prompt_text` string, required: The prompt text.
    - `prompt_type` string, required: The prompt's funnel stage, canonicalized — typically `awareness`, `consideration`, `evaluation`, or `decision`. A non-standard stored type is echoed lowercased.
    - `provider` string, required: The model provider.
    - `model` string, required: The model identifier.
    - `location` string, required: The location the answer was collected for.
    - `run_at` string, date-time, required: When the answer was collected.
    - `response_text` string, required: The model's full answer text.
    - `empty` boolean, required: Whether the model returned an empty answer.
    - `mentioned` boolean, required: Whether the answer named your brand.
    - `rank` integer, nullable, required: Your brand's ordinal position in the answer (1 = named first), or null if not mentioned.
    - `sentiment` string, nullable, required: Mention sentiment — `positive`, `neutral`, or `negative` — or null if not mentioned.
    - `sov_pct` number, nullable, required: Your share of brand mentions within this single answer, as a percentage (0–100), or null if not applicable.
    - `citations` AnswerCitation[], required
      - `url` string, required: The cited URL.
      - `domain` string, required: The cited URL's domain.
      - `citation_type` string, required: Its citation tier — one of `primary`, `tracked`, or `secondary`.
    - `competitor_mentions` object, required: Mention counts within this answer for your tracked competitors, keyed by competitor name.
    - `has_primary_citation` boolean, required: Whether the answer cited an owned domain.
    - `has_tracked_citation` boolean, required: Whether the answer cited a tracked source.
    - `has_external_citation` boolean, required: Whether the answer cited a third-party domain.
  - `notes` string[], required
  - `definitions` object, required: One-line definitions of the metrics behind this payload, keyed by glossary metric name (not by response field name).

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.

---

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