SEsenso
Analytics

Per-prompt performance

Each tracking prompt's window performance — mention rate, Share of Voice, average rank, primary citation rate, and a snapshot of its latest answers. Sortable to surface the prompts where you are invisible. Paged. Requires the GEO product.

get/org/analytics/prompts

Request

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

Query parameters

fromstring date

Start of the window (inclusive), YYYY-MM-DD. Omit to let the server anchor a default 30-day window on your most recent day with data.

tostring date

End of the window (inclusive), YYYY-MM-DD. Omit to end the window at your most recent day with data.

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.

searchstring

Restrict to prompts whose text contains this substring.

sort'mention_rate' | 'share_of_voice' | 'citations' | 'answered' | 'text'

Metric to sort the prompts by.

order'asc' | 'desc'

Sort direction.

limitinteger

Page size, 1–100 (default 50).

offsetinteger

Number of rows to skip.

Response

The paged per-prompt performance table.

totalinteger required

Total prompts 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 definition of each metric in the payload, keyed by metric name.

Changes

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