SEsenso
Analytics

Cited domains

The cited-domain landscape for the window: each domain's tier, its Citation Coverage (÷D) and Citation Share (÷S), and its rank by citations. Paged. Requires the GEO product.

get/org/analytics/citations/domains

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

domain_containsstring

Restrict to domains containing this substring.

limitinteger

Page size, 1–100 (default 50).

offsetinteger

Number of rows to skip.

Response

The paged cited-domain landscape.

totalinteger required

Total domains 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.