SEsenso
Analytics

Cited pages

The URL-grain citation table for the window — each cited page's tier, Coverage, Share, and the top prompts driving its citations. Paged. Requires the GEO product.

get/org/analytics/citations/pages

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.

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 one citation tier — primary (Owned), tracked (Tracked), or secondary (External).

sort'citations' | 'coverage'

Sort order for the pages.

domainstring

Restrict to pages on this exact domain.

domain_containsstring

Restrict to pages whose domain contains this substring.

url_containsstring

Restrict to pages whose URL contains this substring.

limitinteger

Page size, 1–100 (default 50).

offsetinteger

Number of rows to skip.

Response

The paged cited-page table.

totalinteger required

Total pages matching the filter, across all pages of results.

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.