SEsenso
Analytics

Citation time series

Citation counts at both grains (answers and instances) with the per-tier rates (÷D) and shares (÷S) over the window, bucketed by day or week. Requires the GEO product.

get/org/analytics/citations

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 citation 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.