Sources & Citation Intelligence

Every URL the models cited, plus grouped URL, domain and host views, page-cache metadata, mention evidence inside cited pages, occurrence lists and sanitized cached content.

GET/dimensions/sources

Lists non-rejected sources produced by prompt executions.

Params:
  • project_idrequired
  • model
  • collection_id
  • promptprompt ID
  • country_code
  • language_code
  • from
  • to
  • page
  • per_page
  • source_type
  • mention_filter
  • competitors

Here mention_filter applies to the brands named in the crawled content of each cited page, not in the AI answer, mirroring the Citations page.

GET/citation_intelligence/groups

Grouped citation intelligence by url, domain, or host with per-model breakdown, citation rate, and average citation position (ignores position = 0 rows).

Params:
  • project_idrequired
  • viewurl|domain|host
  • page
  • per_page
  • ordergroup_key, total_responses, total_citations, citation_rate, avg_citation_position, first_seen_at, last_seen_at
  • direction
  • model
  • collection_id
  • country_code
  • language_code
  • prompt
  • from
  • to
  • query
  • source_typeowned|competitor|third_party|social_media|own_domain|ugc|background
  • sentimentnegative
  • content_gapmentioned|gap

Invalid enum values return ERR_INVALID_PARAM.

GET/citation_intelligence/mentions_by_domain

For the responses where each given source domain is cited, the share of those responses that mention your brand vs each competitor. Brand and competitors are normalized to sum to 100% per domain, mirroring the Share of Voice mention definition. Pass several domains to analyze the whole matrix in one call.

Params:
  • project_idrequired
  • domainsrequired array, e.g. domains[]=example.com, max 50
  • model
  • collection_id
  • collection_ids
  • country_code
  • language_code
  • prompt
  • from
  • to

Empty domains returns ERR_INVALID_PARAM. Each row has responses_citing, total_mentions, and an actors array (brand and competitors with mentions and share).

GET/citation_intelligence/urls/:url_sha256

URL-level detail for one cited page: totals, citation rate, avg citation position, source-type counts, per-model counts, distinct URL variants, page-cache metadata, and page mention evidence with snippets and actor labels.

  • Params: project_id (required), :url_sha256 (64 hex chars in URL), same optional filters as /citation_intelligence/groups. ERR_NOT_FOUND only when the URL was never cited by the project; filters that empty the result still return 200 with zero stats.

GET/citation_intelligence/urls/:url_sha256/occurrences

Paginated occurrences of a cited URL across prompt executions, with response excerpt, prompt text, model, executed_at, citation_position and source_type per row.

  • Params: project_id (required), :url_sha256 (64 hex chars), page, per_page, same optional filters as /citation_intelligence/groups.

GET/citation_intelligence/urls/:url_sha256/content

Sanitized cached page content for a cited URL: page-cache metadata, mention evidence and snippets, full plain text, and rendered HTML (scripts and unsafe markup removed).

Params:
  • project_idrequired
  • :url_sha25664 hex chars