SEsenso
Analytics

Visibility time series

Mention volume, Share of Voice, average rank, and sentiment over the window, bucketed by day or week, with the window totals alongside. Requires the GEO product.

get/org/analytics/mentions

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.

group_by'day' | 'week'

Time bucket for the returned series.

Response

The visibility series with window totals.

group_bystring required

The bucket the series is grouped by — day or week, echoing the request.

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.