Returns citation totals grouped by URL prefix (domain and first path segment, such as example.com/blog), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with url_prefix, for example https://example.com/blog/. Aggregated in one call; use it instead of paging the citations list.
GET
/
v2
/
visibility
/
citations
/
summary
Retrieve Citation Summary
curl --request GET \ --url https://api.lightsage.com/v2/visibility/citations/summary \ --header 'X-Lightsage-Api-Key: <api-key>'
Named period, resolved in UTC by the server: last_7_days, last_14_days, last_30_days, last_90_days (N days ending today), this_week, last_week, an ISO week such as 2026-W43 (Monday to Sunday), this_month, last_month, a month such as 2026-10, this_quarter, last_quarter, or a quarter such as 2026Q4. A current week, month, or quarter ends today. The response's period gives the resolved dates and the matching previous period. Do not combine with start_date or end_date.
Groups by citation count, most first; day groups are in date order.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Lightsage","colors":{"primary":"#0EA5E9","light":"#38BDF8","dark":"#0284C7"},"logo":{"light":"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-light.svg?fit=max\u0026auto=format\u0026n=0RQiSxJPQv6MyuZt\u0026q=85\u0026s=843d0563baa54c778891f942711ab938","dark":"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-dark.svg?fit=max\u0026auto=format\u0026n=0RQiSxJPQv6MyuZt\u0026q=85\u0026s=0ec933f6e5153f8392cb4c5f19b7017f"},"favicon":"https://mintcdn.com/sapient-14d4e375/lnqlKs8p_hzadcGt/images/favicon.png?fit=max\u0026auto=format\u0026n=lnqlKs8p_hzadcGt\u0026q=85\u0026s=358b3be56f25189cd6d5417fd300fefc","background":{"color":{"light":"#FFFFFF","dark":"#0D0C0C"}},"navbar":{"links":[{"href":"https://lightsage.com","label":"Homepage"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.lightsage.com"}},"seo":{"indexing":"all"},"fonts":{"family":"Geist"},"integrations":{"ga4":{"measurementId":"G-417S0EJVMS"},"posthog":{"apiKey":"phc_yrA1TjjqeYfsoJEofjxd0Bw7cTrxs8N402k3NwusII7"}},"contextual":{"options":["copy","chatgpt","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sapient-14d4e375","hasAudioNarration":false,"actualSubdomain":"sapient-14d4e375","customDomains":["lightsage.com"],"gitSource":{"type":"github","owner":"lightsagehq","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae02c324c09e96410641fcb","collectionId":"82419905-7508-4f98-a30d-d180f437b2ae","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae02c324c09e96410641fcb"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae104f904ad391b285c6ba3","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":76},{"language":"default","tag":"CLI Reference","count":18},{"language":"default","tag":"Evals","count":14},{"language":"default","tag":"Prompts","count":14},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Visibility","count":13},{"language":"default","tag":"MCP Reference","count":10},{"language":"default","tag":"Clients","count":9},{"language":"default","tag":"Agent Preference","count":8},{"language":"default","tag":"Agent Analytics","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/visibility/retrieve-citation-summary","slug":"/api-reference/visibility/retrieve-citation-summary","pageMetadata":{"title":"Retrieve Citation Summary","description":"Returns citation totals grouped by URL prefix (domain and first path segment, such as `example.com/blog`), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with `url_prefix`, for example `https://example.com/blog/`. Aggregated in one call; use it instead of paging the citations list.","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/visibility/citations/summary","href":"/api-reference/visibility/retrieve-citation-summary","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns citation totals grouped by URL prefix (domain and first path segment, such as \", _jsx(_components.code, {\n children: \"example.com/blog\"\n }), \"), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with \", _jsx(_components.code, {\n children: \"url_prefix\"\n }), \", for example \", _jsx(_components.code, {\n children: \"https://example.com/blog/\"\n }), \". Aggregated in one call; use it instead of paging the citations list.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve Citation Summary","description":"Returns citation totals grouped by URL prefix (domain and first path segment, such as `example.com/blog`), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with `url_prefix`, for example `https://example.com/blog/`. Aggregated in one call; use it instead of paging the citations list.","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/visibility/citations/summary","href":"/api-reference/visibility/retrieve-citation-summary","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Visibility"],"summary":"Retrieve Citation Summary","description":"Returns citation totals grouped by URL prefix (domain and first path segment, such as `example.com/blog`), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with `url_prefix`, for example `https://example.com/blog/`. Aggregated in one call; use it instead of paging the citations list.","operationId":"v2_visibility_citations_summary_retrieve","security":["389f5d70-beb0-4c23-9699-f695f8bf37fa"],"parameters":["9a35d3fa-6b27-4a55-876b-15df75c89c01","2f15c52e-794e-49ed-a498-1a7c6c981649","05046e48-d27d-4b9e-901d-512ac2568790","e87a7d1b-e68c-4ef3-a60c-2090fe1a12ad","be0afecc-4862-4695-9423-6c93da763b80","b46989e3-2a6d-4990-8084-6cd4c92a5f9a","5b31ef28-047c-4f3d-befb-4d30a2faa745","5d20f443-1f4c-4d2b-b1c2-fce8eb92e382"],"responses":{"200":"b850ec79-b056-4ba5-8518-b10037914f4e","422":"7eda5e81-8258-4097-8cc6-2284abda3dfb"},"method":"get","type":"path","servers":["87da44d8-880e-455f-bbb0-8e371935d6c7"],"path":"/v2/visibility/citations/summary","baseUrlOptions":["https://api.lightsage.com"],"title":"Retrieve Citation Summary","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9a35d3fa-6b27-4a55-876b-15df75c89c01":{"name":"period","in":"query","required":false,"schema":{"type":"string","maxLength":20,"title":"Period","isRequired":false,"description":"Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`.","uniqueKey":"","typeLabel":"string"},"description":"Named period, resolved in UTC by the server: `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days` (N days ending today), `this_week`, `last_week`, an ISO week such as `2026-W43` (Monday to Sunday), `this_month`, `last_month`, a month such as `2026-10`, `this_quarter`, `last_quarter`, or a quarter such as `2026Q4`. A current week, month, or quarter ends today. The response's `period` gives the resolved dates and the matching previous period. Do not combine with `start_date` or `end_date`."},"2f15c52e-794e-49ed-a498-1a7c6c981649":{"name":"start_date","in":"query","required":false,"schema":{"type":"string","format":"date","title":"Start Date","isRequired":false,"description":"Inclusive range start; defaults to 30 days before the end date. The range may span at most 90 days.","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Inclusive range start; defaults to 30 days before the end date. The range may span at most 90 days."},"05046e48-d27d-4b9e-901d-512ac2568790":{"name":"end_date","in":"query","required":false,"schema":{"type":"string","format":"date","title":"End Date","isRequired":false,"description":"Inclusive range end; defaults to today.","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Inclusive range end; defaults to today."},"e87a7d1b-e68c-4ef3-a60c-2090fe1a12ad":{"name":"group_by","in":"query","required":false,"schema":{"enum":["url_prefix","url","domain","day"],"type":"string","default":"url_prefix","title":"Group By","isRequired":false,"description":"How to group citations.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"How to group citations."},"be0afecc-4862-4695-9423-6c93da763b80":{"name":"url_prefix","in":"query","required":false,"schema":{"type":"string","maxLength":500,"title":"Url Prefix","isRequired":false,"description":"Only citations under this URL prefix, such as `https://example.com/blog/`. Scheme and `www.` are ignored.","uniqueKey":"","typeLabel":"string"},"description":"Only citations under this URL prefix, such as `https://example.com/blog/`. Scheme and `www.` are ignored."},"b46989e3-2a6d-4990-8084-6cd4c92a5f9a":{"name":"source_type","in":"query","required":false,"schema":{"enum":["all","owned","external"],"type":"string","default":"all","title":"Source Type","isRequired":false,"description":"All citations, only owned company domains, or only external ones.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"All citations, only owned company domains, or only external ones."},"5b31ef28-047c-4f3d-befb-4d30a2faa745":{"name":"platform","in":"query","required":false,"schema":{"type":"string","title":"Platform","isRequired":false,"description":"Optional answer-platform ID, name, or slug.","uniqueKey":"","typeLabel":"string"},"description":"Optional answer-platform ID, name, or slug."},"5d20f443-1f4c-4d2b-b1c2-fce8eb92e382":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit","isRequired":false,"description":"Groups to return; `day` groups return every day.","uniqueKey":"","typeLabel":"integer"},"description":"Groups to return; `day` groups return every day."}},"responses":{"b850ec79-b056-4ba5-8518-b10037914f4e":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"period":{"properties":{"start_date":{"type":"string","title":"Start Date","description":"First day of the period (UTC), inclusive.","isRequired":true,"uniqueKey":"period.start_date","typeLabel":"string"},"end_date":{"type":"string","title":"End Date","description":"Last day of the period (UTC), inclusive.","isRequired":true,"uniqueKey":"period.end_date","typeLabel":"string"},"days":{"type":"integer","title":"Days","description":"Days in the period, counting both ends.","isRequired":true,"uniqueKey":"period.days","typeLabel":"integer"},"previous_start_date":{"type":"string","title":"Previous Start Date","description":"First day of the previous period it is compared with.","isRequired":true,"uniqueKey":"period.previous_start_date","typeLabel":"string"},"previous_end_date":{"type":"string","title":"Previous End Date","description":"Last day of the previous period. While a calendar week, month, or quarter is in progress, the previous one is cut to the same number of days.","isRequired":true,"uniqueKey":"period.previous_end_date","typeLabel":"string"},"previous_days":{"type":"integer","title":"Previous Days","description":"Days in the previous period.","isRequired":true,"uniqueKey":"period.previous_days","typeLabel":"integer"},"partial":{"type":"boolean","title":"Partial","description":"Whether the period includes today, so its last day is still in progress.","isRequired":true,"uniqueKey":"period.partial","typeLabel":"boolean"},"name":{"oneOf":[{"type":"string","title":"Name","description":"The `period` requested, or null when the range came from `start_date` and `end_date`.","uniqueKey":"period.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"The `period` requested, or null when the range came from `start_date` and `end_date`.","uniqueKey":"period.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"period.name","typeLabel":"string | null"},"timezone":{"type":"string","const":"UTC","title":"Timezone","default":"UTC","uniqueKey":"period.timezone","typeLabel":"string"}},"type":"object","required":["start_date","end_date","days","previous_start_date","previous_end_date","previous_days","partial"],"title":"PublicResolvedPeriod","description":"The resolved period and the previous period it is compared with.","isRequired":true,"uniqueKey":"period","typeLabel":"PublicResolvedPeriod · object"},"group_by":{"type":"string","enum":["url_prefix","url","domain","day"],"title":"Group By","isRequired":true,"uniqueKey":"group_by","typeLabel":"enum\u003cstring>"},"source_type":{"type":"string","enum":["all","owned","external"],"title":"Source Type","isRequired":true,"uniqueKey":"source_type","typeLabel":"enum\u003cstring>"},"headline_metric":{"type":"string","enum":["citation_count","citations_per_run"],"title":"Headline Metric","description":"The number to lead with: citation counts when the periods are comparable, otherwise citations per run.","isRequired":true,"uniqueKey":"headline_metric","typeLabel":"enum\u003cstring>"},"totals":{"properties":{"citation_count":{"type":"integer","title":"Citation Count","isRequired":true,"uniqueKey":"totals.citation_count","typeLabel":"integer"},"previous_citation_count":{"type":"integer","title":"Previous Citation Count","isRequired":true,"uniqueKey":"totals.previous_citation_count","typeLabel":"integer"},"run_count":{"type":"integer","title":"Run Count","description":"Successful runs of active prompts in the period, after the platform filter.","isRequired":true,"uniqueKey":"totals.run_count","typeLabel":"integer"},"previous_run_count":{"type":"integer","title":"Previous Run Count","isRequired":true,"uniqueKey":"totals.previous_run_count","typeLabel":"integer"},"url_count":{"type":"integer","title":"Url Count","description":"Distinct cited URLs in the period.","isRequired":true,"uniqueKey":"totals.url_count","typeLabel":"integer"},"change":{"oneOf":[{"type":"number","title":"Change","description":"Relative change in citations; 0.25 means 25% higher.","uniqueKey":"totals.change.oneOf.0","typeLabel":"number"},{"type":"null","title":"Change","description":"Relative change in citations; 0.25 means 25% higher.","uniqueKey":"totals.change.oneOf.1","typeLabel":"null"}],"uniqueKey":"totals.change","typeLabel":"number | null"},"citations_per_run":{"oneOf":[{"type":"number","title":"Citations Per Run","uniqueKey":"totals.citations_per_run.oneOf.0","typeLabel":"number"},{"type":"null","title":"Citations Per Run","uniqueKey":"totals.citations_per_run.oneOf.1","typeLabel":"null"}],"uniqueKey":"totals.citations_per_run","typeLabel":"number | null"},"previous_citations_per_run":{"oneOf":[{"type":"number","title":"Previous Citations Per Run","uniqueKey":"totals.previous_citations_per_run.oneOf.0","typeLabel":"number"},{"type":"null","title":"Previous Citations Per Run","uniqueKey":"totals.previous_citations_per_run.oneOf.1","typeLabel":"null"}],"uniqueKey":"totals.previous_citations_per_run","typeLabel":"number | null"},"per_run_change":{"oneOf":[{"type":"number","title":"Per Run Change","description":"Relative change in citations per run.","uniqueKey":"totals.per_run_change.oneOf.0","typeLabel":"number"},{"type":"null","title":"Per Run Change","description":"Relative change in citations per run.","uniqueKey":"totals.per_run_change.oneOf.1","typeLabel":"null"}],"uniqueKey":"totals.per_run_change","typeLabel":"number | null"}},"type":"object","required":["citation_count","previous_citation_count","run_count","previous_run_count","url_count"],"title":"PublicCitationSummaryTotals","isRequired":true,"uniqueKey":"totals","typeLabel":"PublicCitationSummaryTotals · object"},"has_data":{"type":"boolean","title":"Has Data","isRequired":true,"uniqueKey":"has_data","typeLabel":"boolean"},"group_count":{"type":"integer","title":"Group Count","description":"Groups matching the filters, before `limit`.","isRequired":true,"uniqueKey":"group_count","typeLabel":"integer"},"count":{"type":"integer","title":"Count","description":"Groups returned.","isRequired":true,"uniqueKey":"count","typeLabel":"integer"},"coverage":{"properties":{"comparable":{"type":"boolean","title":"Comparable","description":"Whether totals can be compared between the two periods. False when either period has a missing or short day or runs per day differ by more than 20%; compare per-run rates instead.","isRequired":true,"uniqueKey":"coverage.comparable","typeLabel":"boolean"},"current":{"properties":{"start_date":{"type":"string","title":"Start Date","isRequired":true,"uniqueKey":"coverage.current.start_date","typeLabel":"string"},"end_date":{"type":"string","title":"End Date","isRequired":true,"uniqueKey":"coverage.current.end_date","typeLabel":"string"},"runs":{"type":"integer","title":"Runs","isRequired":true,"uniqueKey":"coverage.current.runs","typeLabel":"integer"},"expected_runs":{"type":"integer","title":"Expected Runs","isRequired":true,"uniqueKey":"coverage.current.expected_runs","typeLabel":"integer"},"complete_days":{"type":"integer","title":"Complete Days","description":"Days in the period other than today in progress.","isRequired":true,"uniqueKey":"coverage.current.complete_days","typeLabel":"integer"},"runs_per_day":{"oneOf":[{"type":"number","title":"Runs Per Day","description":"Runs per complete day.","uniqueKey":"coverage.current.runs_per_day.oneOf.0","typeLabel":"number"},{"type":"null","title":"Runs Per Day","description":"Runs per complete day.","uniqueKey":"coverage.current.runs_per_day.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage.current.runs_per_day","typeLabel":"number | null"},"missing_days":{"items":{"type":"string","uniqueKey":"coverage.current.missing_days.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Missing Days","uniqueKey":"coverage.current.missing_days","typeLabel":"string[]"},"short_days":{"items":{"type":"string","uniqueKey":"coverage.current.short_days.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Short Days","uniqueKey":"coverage.current.short_days","typeLabel":"string[]"}},"type":"object","required":["start_date","end_date","runs","expected_runs","complete_days"],"title":"PublicPeriodCoverage","isRequired":true,"uniqueKey":"coverage.current","typeLabel":"PublicPeriodCoverage · object"},"previous":{"properties":{"start_date":{"type":"string","title":"Start Date","isRequired":true,"uniqueKey":"coverage.previous.start_date","typeLabel":"string"},"end_date":{"type":"string","title":"End Date","isRequired":true,"uniqueKey":"coverage.previous.end_date","typeLabel":"string"},"runs":{"type":"integer","title":"Runs","isRequired":true,"uniqueKey":"coverage.previous.runs","typeLabel":"integer"},"expected_runs":{"type":"integer","title":"Expected Runs","isRequired":true,"uniqueKey":"coverage.previous.expected_runs","typeLabel":"integer"},"complete_days":{"type":"integer","title":"Complete Days","description":"Days in the period other than today in progress.","isRequired":true,"uniqueKey":"coverage.previous.complete_days","typeLabel":"integer"},"runs_per_day":{"oneOf":[{"type":"number","title":"Runs Per Day","description":"Runs per complete day.","uniqueKey":"coverage.previous.runs_per_day.oneOf.0","typeLabel":"number"},{"type":"null","title":"Runs Per Day","description":"Runs per complete day.","uniqueKey":"coverage.previous.runs_per_day.oneOf.1","typeLabel":"null"}],"uniqueKey":"coverage.previous.runs_per_day","typeLabel":"number | null"},"missing_days":{"items":{"type":"string","uniqueKey":"coverage.previous.missing_days.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Missing Days","uniqueKey":"coverage.previous.missing_days","typeLabel":"string[]"},"short_days":{"items":{"type":"string","uniqueKey":"coverage.previous.short_days.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Short Days","uniqueKey":"coverage.previous.short_days","typeLabel":"string[]"}},"type":"object","required":["start_date","end_date","runs","expected_runs","complete_days"],"title":"PublicPeriodCoverage","isRequired":true,"uniqueKey":"coverage.previous","typeLabel":"PublicPeriodCoverage · object"},"notes":{"items":{"type":"string","uniqueKey":"coverage.notes.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Notes","description":"Why the periods are not comparable, in plain sentences.","uniqueKey":"coverage.notes","typeLabel":"string[]"},"days":{"items":{"properties":{"date":{"type":"string","title":"Date","isRequired":true,"uniqueKey":"coverage.days.items.[INDEX].date","typeLabel":"string"},"period":{"type":"string","enum":["current","previous"],"title":"Period","isRequired":true,"uniqueKey":"coverage.days.items.[INDEX].period","typeLabel":"enum\u003cstring>"},"runs":{"type":"integer","title":"Runs","description":"Successful prompt runs of active prompts that day.","isRequired":true,"uniqueKey":"coverage.days.items.[INDEX].runs","typeLabel":"integer"},"expected_runs":{"type":"integer","title":"Expected Runs","description":"Median daily runs over the 7 days before; 0 when no daily runs are expected.","isRequired":true,"uniqueKey":"coverage.days.items.[INDEX].expected_runs","typeLabel":"integer"},"status":{"type":"string","enum":["ok","short","missing","in_progress","not_expected"],"title":"Status","description":"`missing`: no runs on a day that expected some. `short`: under half the expected runs. `in_progress`: today, before its runs finished.","isRequired":true,"uniqueKey":"coverage.days.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"type":"object","required":["date","period","runs","expected_runs","status"],"title":"PublicCoverageDay","uniqueKey":"coverage.days.items.[INDEX]","typeLabel":"PublicCoverageDay · object"},"type":"array","title":"Days","uniqueKey":"coverage.days","typeLabel":"PublicCoverageDay · object[]"}},"type":"object","required":["comparable","current","previous"],"title":"PublicCoverage","description":"Runs per day against expected runs for both periods. Check `comparable` before comparing totals.","isRequired":true,"uniqueKey":"coverage","typeLabel":"PublicCoverage · object"},"url_prefix":{"oneOf":[{"type":"string","title":"Url Prefix","description":"URL prefix filter applied, if any.","uniqueKey":"url_prefix.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url Prefix","description":"URL prefix filter applied, if any.","uniqueKey":"url_prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"url_prefix","typeLabel":"string | null"},"platform":{"oneOf":[{"type":"string","title":"Platform","uniqueKey":"platform.oneOf.0","typeLabel":"string"},{"type":"null","title":"Platform","uniqueKey":"platform.oneOf.1","typeLabel":"null"}],"uniqueKey":"platform","typeLabel":"string | null"},"groups":{"items":{"properties":{"key":{"type":"string","title":"Key","description":"The group: a URL prefix (domain and first path segment, such as `example.com/blog`), a normalized URL, a domain, or a day (YYYY-MM-DD).","isRequired":true,"uniqueKey":"groups.items.[INDEX].key","typeLabel":"string"},"is_company_link":{"type":"boolean","title":"Is Company Link","description":"Whether the group includes an owned company domain.","isRequired":true,"uniqueKey":"groups.items.[INDEX].is_company_link","typeLabel":"boolean"},"citation_count":{"type":"integer","title":"Citation Count","description":"Citations in the period.","isRequired":true,"uniqueKey":"groups.items.[INDEX].citation_count","typeLabel":"integer"},"previous_citation_count":{"type":"integer","title":"Previous Citation Count","description":"Citations in the previous period. For `day` groups, the matching day of the previous period.","isRequired":true,"uniqueKey":"groups.items.[INDEX].previous_citation_count","typeLabel":"integer"},"prompt_count":{"type":"integer","title":"Prompt Count","description":"Distinct active prompts that cited the group in the period.","isRequired":true,"uniqueKey":"groups.items.[INDEX].prompt_count","typeLabel":"integer"},"url_count":{"type":"integer","title":"Url Count","description":"Distinct URLs in the group in the period.","isRequired":true,"uniqueKey":"groups.items.[INDEX].url_count","typeLabel":"integer"},"url":{"oneOf":[{"type":"string","title":"Url","description":"Most frequently observed variant of the URL, for `url` groups.","uniqueKey":"groups.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","description":"Most frequently observed variant of the URL, for `url` groups.","uniqueKey":"groups.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"groups.items.[INDEX].url","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Page title, for `url` groups.","uniqueKey":"groups.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Page title, for `url` groups.","uniqueKey":"groups.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"groups.items.[INDEX].title","typeLabel":"string | null"},"change":{"oneOf":[{"type":"number","title":"Change","description":"Relative change in citations; 0.25 means 25% higher.","uniqueKey":"groups.items.[INDEX].change.oneOf.0","typeLabel":"number"},{"type":"null","title":"Change","description":"Relative change in citations; 0.25 means 25% higher.","uniqueKey":"groups.items.[INDEX].change.oneOf.1","typeLabel":"null"}],"uniqueKey":"groups.items.[INDEX].change","typeLabel":"number | null"},"citations_per_run":{"oneOf":[{"type":"number","title":"Citations Per Run","uniqueKey":"groups.items.[INDEX].citations_per_run.oneOf.0","typeLabel":"number"},{"type":"null","title":"Citations Per Run","uniqueKey":"groups.items.[INDEX].citations_per_run.oneOf.1","typeLabel":"null"}],"uniqueKey":"groups.items.[INDEX].citations_per_run","typeLabel":"number | null"},"previous_citations_per_run":{"oneOf":[{"type":"number","title":"Previous Citations Per Run","uniqueKey":"groups.items.[INDEX].previous_citations_per_run.oneOf.0","typeLabel":"number"},{"type":"null","title":"Previous Citations Per Run","uniqueKey":"groups.items.[INDEX].previous_citations_per_run.oneOf.1","typeLabel":"null"}],"uniqueKey":"groups.items.[INDEX].previous_citations_per_run","typeLabel":"number | null"},"per_run_change":{"oneOf":[{"type":"number","title":"Per Run Change","description":"Relative change in citations per run.","uniqueKey":"groups.items.[INDEX].per_run_change.oneOf.0","typeLabel":"number"},{"type":"null","title":"Per Run Change","description":"Relative change in citations per run.","uniqueKey":"groups.items.[INDEX].per_run_change.oneOf.1","typeLabel":"null"}],"uniqueKey":"groups.items.[INDEX].per_run_change","typeLabel":"number | null"}},"type":"object","required":["key","is_company_link","citation_count","previous_citation_count","prompt_count","url_count"],"title":"PublicCitationSummaryGroup","uniqueKey":"groups.items.[INDEX]","typeLabel":"PublicCitationSummaryGroup · object"},"type":"array","title":"Groups","description":"Groups by citation count, most first; `day` groups are in date order.","uniqueKey":"groups","typeLabel":"PublicCitationSummaryGroup · object[]"}},"type":"object","required":["period","group_by","source_type","headline_metric","totals","has_data","group_count","count","coverage"],"title":"PublicCitationSummaryResponse","uniqueKey":"","typeLabel":"PublicCitationSummaryResponse · object"},"examples":{"Example":{"title":"Example","value":{"period":{"start_date":"\u003cstring>","end_date":"\u003cstring>","days":123,"previous_start_date":"\u003cstring>","previous_end_date":"\u003cstring>","previous_days":123,"partial":true,"name":"\u003cstring>","timezone":"UTC"},"group_by":"url_prefix","source_type":"all","headline_metric":"citation_count","totals":{"citation_count":123,"previous_citation_count":123,"run_count":123,"previous_run_count":123,"url_count":123,"change":123,"citations_per_run":123,"previous_citations_per_run":123,"per_run_change":123},"has_data":true,"group_count":123,"count":123,"coverage":{"comparable":true,"current":{"start_date":"\u003cstring>","end_date":"\u003cstring>","runs":123,"expected_runs":123,"complete_days":123,"runs_per_day":123,"missing_days":["\u003cstring>"],"short_days":["\u003cstring>"]},"previous":{"start_date":"\u003cstring>","end_date":"\u003cstring>","runs":123,"expected_runs":123,"complete_days":123,"runs_per_day":123,"missing_days":["\u003cstring>"],"short_days":["\u003cstring>"]},"notes":["\u003cstring>"],"days":[{"date":"\u003cstring>","period":"current","runs":123,"expected_runs":123,"status":"ok"}]},"url_prefix":"\u003cstring>","platform":"\u003cstring>","groups":[{"key":"\u003cstring>","is_company_link":true,"citation_count":123,"previous_citation_count":123,"prompt_count":123,"url_count":123,"url":"\u003cstring>","title":"\u003cstring>","change":123,"citations_per_run":123,"previous_citations_per_run":123,"per_run_change":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7eda5e81-8258-4097-8cc6-2284abda3dfb":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"389f5d70-beb0-4c23-9699-f695f8bf37fa":{"LightsageApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Lightsage-Api-Key","scopes":[],"schemeName":"LightsageApiKeyAuth"}}},"servers":{"87da44d8-880e-455f-bbb0-8e371935d6c7":{"url":"https://api.lightsage.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Lightsage-Api-Key","scopes":[],"schemeName":"LightsageApiKeyAuth"},"schema":{"title":"X-Lightsage-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"LightsageApiKeyAuth","name":"X-Lightsage-Api-Key"}],"title":"LightsageApiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"sapient-14d4e375","siteName":"Lightsage","title":"Retrieve Citation Summary - Lightsage","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T20:09:36.396Z","originalFileLocation":"api-reference/visibility/retrieve-citation-summary.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns citation totals grouped by URL prefix (domain and first path segment, such as example.com/blog), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with url_prefix, for example https://example.com/blog/. Aggregated in one call; use it instead of paging the citations list.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lightsage\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve Citation Summary - Lightsage\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns citation totals grouped by URL prefix (domain and first path segment, such as example.com/blog), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with url_prefix, for example https://example.com/blog/. Aggregated in one call; use it instead of paging the citations list.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lightsage\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sapient-14d4e375.mintlify.app/_mintlify/api/og/v2?division=Visibility\u0026amp;title=Retrieve+Citation+Summary\u0026amp;description=Returns+citation+totals+grouped+by+URL+prefix+%28domain+and+first+path+segment%2C+such+as+%60example.com%2Fblog%60%29%2C+URL%2C+domain%2C+or+day%2C+each+compared+with+the+previous+\u0026amp;theme=dd8ce0054346ff07fc865000\u0026amp;signature=62fc7115f333ee95cb4f6e94d286780aa7fba5680b04d579d6afeeaee3470afa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retrieve Citation Summary - Lightsage\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns citation totals grouped by URL prefix (domain and first path segment, such as example.com/blog), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with url_prefix, for example https://example.com/blog/. Aggregated in one call; use it instead of paging the citations list.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sapient-14d4e375.mintlify.app/_mintlify/api/og/v2?division=Visibility\u0026amp;title=Retrieve+Citation+Summary\u0026amp;description=Returns+citation+totals+grouped+by+URL+prefix+%28domain+and+first+path+segment%2C+such+as+%60example.com%2Fblog%60%29%2C+URL%2C+domain%2C+or+day%2C+each+compared+with+the+previous+\u0026amp;theme=dd8ce0054346ff07fc865000\u0026amp;signature=62fc7115f333ee95cb4f6e94d286780aa7fba5680b04d579d6afeeaee3470afa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lightsage\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0EA5E9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/visibility/retrieve-citation-summary.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://lightsage.com/#organization\",\"name\":\"Lightsage\",\"url\":\"https://lightsage.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-light.svg?fit=max\u0026auto=format\u0026n=0RQiSxJPQv6MyuZt\u0026q=85\u0026s=843d0563baa54c778891f942711ab938\"}},{\"@type\":\"WebSite\",\"@id\":\"https://lightsage.com/docs#website\",\"name\":\"Lightsage\",\"url\":\"https://lightsage.com/docs\",\"publisher\":{\"@id\":\"https://lightsage.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary#webpage\",\"url\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary\",\"name\":\"Retrieve Citation Summary\",\"description\":\"Returns citation totals grouped by URL prefix (domain and first path segment, such as example.com/blog), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with url_prefix, for example https://example.com/blog/. Aggregated in one call; use it instead of paging the citations list.\",\"dateModified\":\"2026-10-27T20:09:36.396Z\",\"isPartOf\":{\"@id\":\"https://lightsage.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Visibility\",\"item\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-current-visibility\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve Citation Summary\",\"item\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary#apireference\",\"headline\":\"Retrieve Citation Summary\",\"name\":\"Retrieve Citation Summary\",\"description\":\"Returns citation totals grouped by URL prefix (domain and first path segment, such as example.com/blog), URL, domain, or day, each compared with the previous period, with per-run rates and run coverage. Filter to one section of a site with url_prefix, for example https://example.com/blog/. Aggregated in one call; use it instead of paging the citations list.\",\"url\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary\",\"mainEntityOfPage\":{\"@id\":\"https://lightsage.com/docs/api-reference/visibility/retrieve-citation-summary#webpage\"},\"dateModified\":\"2026-10-27T20:09:36.396Z\",\"publisher\":{\"@id\":\"https://lightsage.com/#organization\"},\"isPartOf\":{\"@id\":\"https://lightsage.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Lightsage\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Lightsage","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli-reference"}]},{"tab":"MCP Reference","pages":[{"title":"MCP Reference","href":"/mcp-reference"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","sidebarTitle":"Overview","icon":"code","href":"/api-reference/introduction"}]},{"group":"Status","pages":[{"title":"Get Status","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/status","href":"/api-reference/status/get-status"},{"title":"Get Auth Status","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/auth/status","href":"/api-reference/status/get-auth-status"}]},{"group":"Visibility","pages":[{"title":"Retrieve Current Visibility","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/visibility/current","href":"/api-reference/visibility/retrieve-current-visibility"},{"title":"Retrieve Visibility Overview","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/visibility/overview","href":"/api-reference/visibility/retrieve-visibility-overview"},{"title":"List Top Cited Urls","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/visibility/citations","href":"/api-reference/visibility/list-top-cited-urls"},{"title":"Retrieve Prompt Visibility Report","description":"Returns per-topic and per-prompt visibility metrics including recommendation score, rank, visibility score, average position, and citation counts.","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/visibility/prompts","href":"/api-reference/visibility/retrieve-prompt-visibility-report"},{"title":"Retrieve Citation Summary","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/visibility/citations/summary","href":"/api-reference/visibility/retrieve-citation-summary"}]},{"group":"Prompts","pages":[{"title":"List Prompts","description":"Returns active and inactive prompts by default. Set `include_archived` to include archived prompts.","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/prompts","href":"/api-reference/prompts/list-prompts"},{"title":"Create Prompts","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/prompts","href":"/api-reference/prompts/create-prompts"},{"title":"List Topics","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/prompts/topics","href":"/api-reference/prompts/list-topics"},{"title":"Create Topic","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/prompts/topics","href":"/api-reference/prompts/create-topic"},{"title":"Delete Topic","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/prompts/topics/{topic_id}","href":"/api-reference/prompts/delete-topic"},{"title":"Update Topic","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/prompts/topics/{topic_id}","href":"/api-reference/prompts/update-topic"},{"title":"List Prompt Runs","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/prompts/runs","href":"/api-reference/prompts/list-prompt-runs"},{"title":"Run Prompts","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/prompts/runs","href":"/api-reference/prompts/run-prompts"},{"title":"Get Prompt Run Status","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/prompts/runs/{run_id}/status","href":"/api-reference/prompts/get-prompt-run-status"},{"title":"Cancel a prompt run","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/prompts/runs/{run_id}/cancel","href":"/api-reference/prompts/cancel-a-prompt-run"},{"title":"Retrieve Prompt Run","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/prompts/runs/{run_id}","href":"/api-reference/prompts/retrieve-prompt-run"},{"title":"Retrieve Prompt","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/prompts/{prompt_id}","href":"/api-reference/prompts/retrieve-prompt"},{"title":"Delete Prompt","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/prompts/{prompt_id}","href":"/api-reference/prompts/delete-prompt"},{"title":"Update Prompt","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/prompts/{prompt_id}","href":"/api-reference/prompts/update-prompt"}]},{"group":"Opportunities","pages":[{"title":"List Opportunities","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/opportunities","href":"/api-reference/opportunities/list-opportunities"},{"title":"Retrieve Opportunity","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/opportunities/{opportunity_id}","href":"/api-reference/opportunities/retrieve-opportunity"}]},{"group":"Tasks","pages":[{"title":"List Tasks","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/tasks","href":"/api-reference/tasks/list-tasks"},{"title":"Create Task","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/tasks","href":"/api-reference/tasks/create-task"},{"title":"Retrieve Task","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/tasks/{task_id}","href":"/api-reference/tasks/retrieve-task"},{"title":"Update Task","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/tasks/{task_id}","href":"/api-reference/tasks/update-task"}]},{"group":"Site Audits","pages":[{"title":"List Site Audits","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/site-audits","href":"/api-reference/site-audits/list-site-audits"},{"title":"Retrieve Site Audit","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/site-audits/{site_id}","href":"/api-reference/site-audits/retrieve-site-audit"}]},{"group":"Agent Analytics","pages":[{"title":"List Agent Analytics Sites","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-analytics/sites","href":"/api-reference/agent-analytics/list-agent-analytics-sites"},{"title":"Retrieve Agent Analytics Summary","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-analytics/sites/{site_id}/summary","href":"/api-reference/agent-analytics/retrieve-agent-analytics-summary"},{"title":"List Agent Analytics Sources","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-analytics/sites/{site_id}/sources","href":"/api-reference/agent-analytics/list-agent-analytics-sources"},{"title":"List Agent Analytics Pages","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-analytics/sites/{site_id}/pages","href":"/api-reference/agent-analytics/list-agent-analytics-pages"},{"title":"List Agent Analytics Error Pages","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-analytics/sites/{site_id}/error-pages","href":"/api-reference/agent-analytics/list-agent-analytics-error-pages"},{"title":"List Agent Analytics Countries","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-analytics/sites/{site_id}/countries","href":"/api-reference/agent-analytics/list-agent-analytics-countries"}]},{"group":"Evals","pages":[{"title":"List Evals","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/evals","href":"/api-reference/evals/list-evals"},{"title":"Create Eval","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/evals","href":"/api-reference/evals/create-eval"},{"title":"Create evals from a template","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/evals/batch","href":"/api-reference/evals/create-evals-from-a-template"},{"title":"Retrieve Eval","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/evals/{eval_id}","href":"/api-reference/evals/retrieve-eval"},{"title":"Delete Eval","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/evals/{eval_id}","href":"/api-reference/evals/delete-eval"},{"title":"Update Eval","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/evals/{eval_id}","href":"/api-reference/evals/update-eval"},{"title":"List Configurations","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/evals/{eval_id}/configurations","href":"/api-reference/evals/list-configurations"},{"title":"Create Configuration","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/evals/{eval_id}/configurations","href":"/api-reference/evals/create-configuration"},{"title":"Retrieve Configuration","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/evals/{eval_id}/configurations/{configuration_id}","href":"/api-reference/evals/retrieve-configuration"},{"title":"Delete Configuration","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/evals/{eval_id}/configurations/{configuration_id}","href":"/api-reference/evals/delete-configuration"},{"title":"Update Configuration","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/evals/{eval_id}/configurations/{configuration_id}","href":"/api-reference/evals/update-configuration"}]},{"group":"Eval Templates","pages":[{"title":"List Eval templates","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/eval-templates","href":"/api-reference/eval-templates/list-eval-templates"},{"title":"Create an Eval template","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/eval-templates","href":"/api-reference/eval-templates/create-an-eval-template"},{"title":"Retrieve an Eval template","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/eval-templates/{template_id}","href":"/api-reference/eval-templates/retrieve-an-eval-template"},{"title":"Delete an Eval template","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/eval-templates/{template_id}","href":"/api-reference/eval-templates/delete-an-eval-template"},{"title":"Update an Eval template","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/eval-templates/{template_id}","href":"/api-reference/eval-templates/update-an-eval-template"}]},{"group":"Eval Runs","pages":[{"title":"List Runs","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/eval-runs","href":"/api-reference/eval-runs/list-runs"},{"title":"Start an eval run","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/eval-runs","href":"/api-reference/eval-runs/start-an-eval-run"},{"title":"Cancel an eval run","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/eval-runs/{run_id}/cancel","href":"/api-reference/eval-runs/cancel-an-eval-run"},{"title":"Monitor Runs","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/eval-runs/monitor","href":"/api-reference/eval-runs/monitor-runs"},{"title":"Retrieve an eval run trace","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/eval-runs/{run_id}/trace","href":"/api-reference/eval-runs/retrieve-an-eval-run-trace"},{"title":"Retrieve an eval run","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/eval-runs/{run_id}","href":"/api-reference/eval-runs/retrieve-an-eval-run"}]},{"group":"Agent Preference","pages":[{"title":"List Competitors","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-preference/competitors","href":"/api-reference/agent-preference/list-competitors"},{"title":"Retrieve Head To Head","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-preference/head-to-head","href":"/api-reference/agent-preference/retrieve-head-to-head"},{"title":"List Evals","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-preference/evals","href":"/api-reference/agent-preference/list-evals"},{"title":"Create Eval","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/agent-preference/evals","href":"/api-reference/agent-preference/create-eval"},{"title":"Retrieve Eval","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-preference/evals/{eval_id}","href":"/api-reference/agent-preference/retrieve-eval"},{"title":"Delete Eval","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/agent-preference/evals/{eval_id}","href":"/api-reference/agent-preference/delete-eval"},{"title":"Update Eval","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/agent-preference/evals/{eval_id}","href":"/api-reference/agent-preference/update-eval"},{"title":"List Results","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agent-preference/evals/{eval_id}/results","href":"/api-reference/agent-preference/list-results"}]},{"group":"Agents","pages":[{"title":"List Agents","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/agents","href":"/api-reference/agents/list-agents"}]},{"group":"Repositories","pages":[{"title":"List Repositories","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/repositories","href":"/api-reference/repositories/list-repositories"},{"title":"Create Repository","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/repositories","href":"/api-reference/repositories/create-repository"},{"title":"Retrieve Repository","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/repositories/{repository_id}","href":"/api-reference/repositories/retrieve-repository"},{"title":"Delete Repository","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/repositories/{repository_id}","href":"/api-reference/repositories/delete-repository"},{"title":"Update Repository","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/repositories/{repository_id}","href":"/api-reference/repositories/update-repository"}]},{"group":"Environments","pages":[{"title":"List Environments","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/environments","href":"/api-reference/environments/list-environments"}]},{"group":"MCP Servers","pages":[{"title":"List Mcp Servers","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/mcp-servers","href":"/api-reference/mcp-servers/list-mcp-servers"}]},{"group":"CLIs","pages":[{"title":"List Clis","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/clis","href":"/api-reference/clis/list-clis"}]},{"group":"Skills","pages":[{"title":"List Skills","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/skills","href":"/api-reference/skills/list-skills"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Retrieve Citation Summary - Lightsage","buildId":"dpl_3rfzHPCtRhDFBbetXZ3oLkN5tjmA","deploymentId":"dpl_3rfzHPCtRhDFBbetXZ3oLkN5tjmA","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DBvOZtde.js","utils-BMzGkvGb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BYhgN8Gl.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-qDMltnin.js","snippetPresets-CABPPIq4.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Bx9dgvF5.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-EwWVpM4w.js","shallow-vGbuQTai.js","getApiPlaygroundDisplay-DP2addym.js","CodeSnippet-BG6rB_-H.js","CodeSnippets-CFVdLBFC.js","Page-B-qdInYQ.js","getPastedJson-JGlMoKBJ.js","icon-BK_uyWxF.js","MethodPill-Du3sAVkF.js","DuplicateIcon-CMq42UID.js","createIcon-RdBrtBmo.js","DynamicMarkdown-B3juXLG8.js","SectionHeading-B--QsSCa.js","axios-vUo_bRtp.js","Markdown-B_bWWeh0.js","clsx-eUAxaTXI.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DMuJXOAm.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DeDUMY0v.js"]}