SEsenso
Analytics

Prompt detail

One prompt end to end — its metric history over the window plus, unless suppressed, the latest full answers from every model × location. Requires the GEO product.

get/org/analytics/prompts/{promptId}

Request

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

Path parameters

promptIdstring uuid required

The prompt's id.

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.

include_answersboolean

Whether to include the latest full answers. Defaults to true.

Response

The prompt's history and latest answers.

prompt_idstring required

The prompt's id.

prompt_textstring required

The prompt text.

prompt_typestring required

The prompt's funnel stage, canonicalized — typically awareness, consideration, evaluation, or decision. A non-standard stored type is echoed lowercased.

tagsstring[] required
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.