SEsenso
Analytics

Latest raw answers

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.

get/org/analytics/answers/latest

Request

  • Base URL
    https://apiv2.senso.ai/api/v1
  • Auth
    API key in header X-API-Key

Query parameters

modelsstring

Comma-separated model identifiers to filter by (e.g. chatgpt, claude, perplexity, gemini). Validated against a fixed allow-list — an unrecognized identifier is rejected with 400. Call GET /org/analytics/filters for the models that actually have data for your organization.

locationstring

Comma-separated locations to filter by, matched exactly and case-sensitively (e.g. US, US/California). The alias locations is also accepted. Call GET /org/analytics/filters for the locations with data.

prompt_type'awareness' | 'consideration' | 'evaluation' | 'decision'

Restrict to one funnel stage.

tagstring

Restrict to prompts carrying this tag.

fromstring date

Only include answers whose collection time (run_at) falls on or after this day (YYYY-MM-DD). Omit for no lower bound — no default window is applied on this endpoint.

tostring date

Only include answers whose collection time (run_at) falls on or before this day (YYYY-MM-DD). Omit for no upper bound.

mentionedboolean

Restrict to answers that did (true) or did not (false) mention your brand.

citedboolean

Restrict to answers that did (true) or did not (false) carry any citation.

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.

Restrict to answers carrying a citation of this tier.

limitinteger

Page size, 1–100 (default 25).

offsetinteger

Number of rows to skip.

Response

The paged latest-answer feed.

totalinteger required

Total answers matching the filter, across all pages.

limitinteger required

The page size that was applied.

offsetinteger required

The row offset that was applied.

notesstring[] required
definitionsobject required

One-line definitions of the metrics behind this payload, keyed by glossary metric name (not by response field name).

Changes

No recorded changes to this operation across all 1 revision of this API.