List individual citation records (URL, domain, title) found in AI responses.
Example: “Show all citations from wikipedia.org.” Unlike /reports/citations which returns aggregated counts, this returns raw citation rows.
Metrics (optional): citation_share, citing_answers, citing_answers_mentioning_you, visibility_contribution, source_type, platforms, topics, content_last_cited. Omit for the plain listing. Any metric switches to the dashboard’s All Citations engine, so values match the app exactly; with comparison_start_date / comparison_end_date the numeric metrics also carry previous_<metric>.
Filters:topics, prompts, tags, markets, intent, branded, platform, has_shopping_card, visibility, rank, website_mentioned_in_answer, cited_page_url, cited_domain, website_mentioned_in_citation, domain, url, path. With metrics: path, rank, visibility, has_shopping_card and tree-style advanced_filters are not supported (400), because the All Citations engine does not evaluate them; platform values naming a model widen to that model’s provider.
Sort fields:domain, url, title for the listing; with metrics, any numeric metric or content_last_cited.
Dates: Defaults to all-time when no dates provided.
Filter values:markets takes a market id or contains with a region code such as us (names like United States and labels like us - en match nothing); tags, topics and platform match by name or id.
Pagination: Use pagination (limit 1-100, default 10; offset for paging). Use order_by for sorting.
Response: Returns data array with info metadata containing total_rows (before pagination) and query (applied metrics, dates, sorting, pagination, filters).
Unique identifier of the project to query. Get valid project IDs from get_all_projects.
Minimum string length: 1
Example:
"550e8400-e29b-41d4-a716-446655440000"
start_date
string<date-time>
Start of the date range (ISO 8601). Limits results to data collected on or after this date. When omitted: defaults to the latest run's start date for metric queries, or earliest available date for list queries.
Examples:
"2026-01-01T00:00:00Z"
"2026-03-01T00:00:00Z"
end_date
string<date-time>
End of the date range (ISO 8601). Limits results to data collected on or before this date. When omitted: defaults to today. Date-only strings (no 'T') are extended to end of day.
Examples:
"2026-01-31T23:59:59Z"
"2026-03-17T23:59:59Z"
current_from
string<date-time>
Alias for start_date (analytics-tool date naming).
current_to
string<date-time>
Alias for end_date (analytics-tool date naming).
comparison_start_date
string<date-time>
Start of the comparison (past) date range (ISO 8601). Provide together with comparison_end_date to additionally compute every measure over this past range — each row then includes previous_ values calculated with identical dimensions, measures, and filters.
Example:
"2026-07-25T00:00:00Z"
comparison_end_date
string<date-time>
End of the comparison (past) date range (ISO 8601). Required together with comparison_start_date. Date-only strings (no 'T') are extended to end of day, same as end_date.
Example:
"2026-07-31T23:59:59Z"
previous_from
string<date-time>
Alias for comparison_start_date (analytics-tool date naming).
previous_to
string<date-time>
Alias for comparison_end_date (analytics-tool date naming).
order_by
SortingOrder · object[]
Sort results by one or more fields. Each entry specifies a field name and direction. Results are sorted by the first entry, then ties broken by subsequent entries.
Control result pagination. Set limit for page size and offset to skip results. Omit to return all results (use with caution on large datasets).
Show child attributes
Examples:
{ "limit": 10, "offset": 0 }
{ "limit": 25, "offset": 50 }
metrics
enum<string>[]
Metrics to include per citation. Omit for the plain listing. Any metric switches to the dashboard's citation engine; with comparison dates, numeric metrics also get previous_<metric>.
Per-citation metrics, computed exactly as the dashboard's All Citations page does.
citation_share: % of answers in range that cite this page (citing_answers / answers)
citing_answers: Answers in range that cite this page
citing_answers_mentioning_you: Of those, answers that also mention your brand
visibility_contribution: % of your brand mentions that came from answers citing this page
Optional filters to narrow down citations by domain, URL, or path.
Show child attributes
Response
Successful Response
Response containing citation data.
data
CitationDataItem · object[]
required
Array of citation data items
Show child attributes
info
ResponseInfo · object
Information of the API request including total count and query details
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Writesonic Docs","description":"Writesonic is the GEO platform that tracks your AI visibility across ChatGPT, Gemini, Claude, and 10+ AI search platforms. Diagnose gaps. Own the answer.","colors":{"primary":"#FF6719","light":"#FF8337","dark":"#FF6719"},"logo":{"light":"https://mintcdn.com/writesonic/pJXgH59hJ3fQBw5s/images/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=pJXgH59hJ3fQBw5s\u0026q=85\u0026s=12c1c23ddbb7e4ef1e6a1243503b4114","dark":"https://mintcdn.com/writesonic/pJXgH59hJ3fQBw5s/images/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=pJXgH59hJ3fQBw5s\u0026q=85\u0026s=b9f811e9c053d5c965eec5f00369524e","href":"https://docs.writesonic.com"},"favicon":"https://mintcdn.com/writesonic/yGK8Y6Gb_2rbk4m6/favicon.png?fit=max\u0026auto=format\u0026n=yGK8Y6Gb_2rbk4m6\u0026q=85\u0026s=cd8c2523e8e57796f14c675f6cc95986","background":{"color":{"light":"#F5F4F0","dark":"#202020"}},"navbar":{"primary":{"type":"button","label":"Open Writesonic","href":"https://app.writesonic.com/?utm_source=docs"}},"footer":{"socials":{"x":"https://x.com/writesonic","linkedin":"https://www.linkedin.com/company/writesonic","github":"https://github.com/Writesonic"},"links":[{"header":"Product","items":[{"label":"Platform","href":"https://writesonic.com"},{"label":"Pricing","href":"https://writesonic.com/pricing"},{"label":"Customers","href":"https://writesonic.com/customers"}]},{"header":"Resources","items":[{"label":"Docs","href":"https://docs.writesonic.com"},{"label":"API","href":"https://docs.writesonic.com/api-reference/authentication"},{"label":"MCP","href":"https://docs.writesonic.com/mcp/mcp-server"}]}]},"fonts":{"heading":{"family":"Roobert","weight":600,"source":"fonts/Roobert-SemiBold.woff2","format":"woff2"},"body":{"family":"Roobert","weight":400,"source":"fonts/Roobert-Regular.woff2","format":"woff2"}},"styling":{"eyebrows":"section","codeblocks":"system","latex":false},"navigation":{"global":{"anchors":[{"anchor":"Open Writesonic","icon":"arrow-up-right-from-square","href":"https://app.writesonic.com/?utm_source=docs"},{"anchor":"Book a demo","icon":"headset","href":"https://writesonic.com/?demo=open"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"writesonic","hasAudioNarration":false,"actualSubdomain":"writesonic","customDomains":["apidocs.writesonic.com"],"gitSource":{"type":"github","owner":"writesonic","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec5a0a25c041b78607e9dd","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Platform","count":54},{"language":"default","tag":"Agents","count":34},{"language":"default","tag":"Agents REST API","count":21},{"language":"default","tag":"Writesonic REST API","count":16},{"language":"default","tag":"AI Bot (Traffic) Analytics","count":12},{"language":"default","tag":"Generic","count":10},{"language":"default","tag":"Reference","count":9},{"language":"default","tag":"Context","count":8},{"language":"default","tag":"Playbooks","count":8},{"language":"default","tag":"Setup and Implementation Guide","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"@font-face{font-family:\"Roobert\";font-weight:400;font-style:normal;font-display:swap;src:url(\"/fonts/Roobert-Regular.woff2\") format(\"woff2\"),\n url(\"/fonts/Roobert-Regular.woff\") format(\"woff\")}@font-face{font-family:\"Roobert\";font-weight:500;font-style:normal;font-display:swap;src:url(\"/fonts/Roobert-Medium.woff2\") format(\"woff2\"),\n url(\"/fonts/Roobert-Medium.woff\") format(\"woff\")}@font-face{font-family:\"Roobert\";font-weight:600;font-style:normal;font-display:swap;src:url(\"/fonts/Roobert-SemiBold.woff2\") format(\"woff2\"),\n url(\"/fonts/Roobert-SemiBold.woff\") format(\"woff\")}@font-face{font-family:\"Roobert\";font-weight:700;font-style:normal;font-display:swap;src:url(\"/fonts/Roobert-Bold.woff2\") format(\"woff2\"),\n url(\"/fonts/Roobert-Bold.woff\") format(\"woff\")}:root{--ws-paper-white: #ffffff;--ws-light-cream: #f5f4f0;--ws-sonic-orange: #ff6719;--ws-ink-black: #202020;--ws-orange-50: #fff6ed;--ws-orange-100: #ffead4;--ws-orange-200: #ffd1a8;--ws-orange-300: #ffa46c;--ws-orange-400: #ff8337;--ws-orange-500: #ff6719;--ws-orange-600: #fd4606;--ws-orange-700: #c73107;--ws-orange-800: #9e280e;--ws-orange-900: #7f240f;--ws-orange-950: #450e05;--ws-cream-100: #eeede6;--ws-cream-200: #dcd9cc;--ws-fg-muted: #5c5c5c;--ws-fg-subtle: #8a8a86;--ws-border: rgba(32, 32, 32, 0.1);--ws-border-strong: rgba(32, 32, 32, 0.22);--ws-font:\n \"Roobert\", \"Inter\", system-ui, -apple-system, \"Segoe UI\", sans-serif;--ws-font-mono: \"JetBrains Mono\", ui-monospace, \"SF Mono\", Menlo, monospace}html,body,[class*=\"font-sans\"],[class*=\"font-display\"],.prose,.prose *{font-family:var(--ws-font)!important}code,kbd,pre,[class*=\"font-mono\"],.prose code,.prose pre{font-family:var(--ws-font-mono)!important}h1,h2,h3,h4,h5,h6,.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{font-family:var(--ws-font)!important;font-weight:600!important;letter-spacing:-0.015em;color:var(--ws-ink-black)}.prose h1,article h1{font-size:30px;line-height:36px;letter-spacing:-0.025em}.prose h2,article h2{font-size:22px;line-height:30px;letter-spacing:-0.02em}.prose h3,article h3{font-size:18px;line-height:26px;letter-spacing:-0.015em}.prose h4,article h4,.prose h5,article h5{font-size:16px}.prose strong{font-weight:600}.dark h1,.dark h2,.dark h3,.dark h4,.dark h5,.dark h6,.dark .prose h1,.dark .prose h2,.dark .prose h3,.dark .prose h4,.dark .prose h5,.dark .prose h6{color:var(--ws-light-cream)}h1,.prose h1{letter-spacing:-0.02em}body{font-weight:400;-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}::selection{background:var(--ws-orange-200);color:var(--ws-orange-950)}.prose a,a[class*=\"text-primary\"]{color:var(--ws-sonic-orange)!important;text-decoration:none;text-underline-offset:3px;transition:color 200ms cubic-bezier(0.2, 0.7, 0.2, 1)}.prose a:hover{color:var(--ws-orange-700)!important;text-decoration:underline}.prose :not(pre)>code{background:var(--ws-orange-50)!important;color:var(--ws-orange-800)!important;border-radius:6px;padding:2px 4px;font-size:0.92em;border:1px solid var(--ws-orange-100)}.dark .prose :not(pre)>code{background:rgba(255, 103, 25, 0.12)!important;color:var(--ws-orange-300)!important;border-color:rgba(255, 103, 25, 0.22)}a[class*=\"bg-primary\"],button[class*=\"bg-primary\"],.button-primary,[data-mintlify-primary]{background-color:#ff6719!important;color:#ffffff!important;border:1px solid #ff6719!important;border-radius:12px!important;font-weight:700!important;letter-spacing:0!important;transition:background-color 200ms cubic-bezier(0.2, 0.7, 0.2, 1),\n border-color 200ms cubic-bezier(0.2, 0.7, 0.2, 1)!important}a[class*=\"bg-primary\"]:hover,button[class*=\"bg-primary\"]:hover{background-color:#f04506!important;border-color:#f04506!important}a[class*=\"bg-primary\"]:active,button[class*=\"bg-primary\"]:active{background-color:#c73107!important;border-color:#c73107!important}.docs-hero-cta-primary{border:1px solid #ff6719;font-weight:700!important;border-radius:12px!important;padding:10px 22px!important;transition:background-color 200ms cubic-bezier(0.2, 0.7, 0.2, 1),\n border-color 200ms cubic-bezier(0.2, 0.7, 0.2, 1)!important}.docs-hero-cta-primary:hover{background-color:#f04506!important;border-color:#f04506!important;color:#ffffff!important}.docs-hero-cta-ghost{background:#ffffff!important;border:1px solid #d1d1d1!important;font-weight:700!important;border-radius:12px!important;padding:10px 22px!important;transition:background-color 200ms cubic-bezier(0.2, 0.7, 0.2, 1),\n border-color 200ms cubic-bezier(0.2, 0.7, 0.2, 1),\n color 200ms cubic-bezier(0.2, 0.7, 0.2, 1)!important}.docs-hero-cta-ghost:hover{background:#ff6719!important;border-color:#ff6719!important;color:#ffffff!important}.dark .docs-hero-cta-ghost{background:rgba(255, 255, 255, 0.05)!important;border-color:rgba(245, 244, 240, 0.18)!important;color:#f5f4f0!important}.dark .docs-hero-cta-ghost:hover{background:#ff6719!important;border-color:#ff6719!important;color:#ffffff!important}a.group[class*=\"bg-primary\"]{background-color:var(--ws-orange-50)!important;color:var(--ws-orange-800)!important;border-radius:8px}a.group[class*=\"bg-primary\"] *{color:var(--ws-orange-800)!important}.dark a.group[class*=\"bg-primary\"],a.group[class*=\"dark:bg-primary\"]{background-color:rgba(255, 103, 25, 0.14)!important;color:var(--ws-orange-300)!important}.dark a.group[class*=\"bg-primary\"] *{color:var(--ws-orange-300)!important}.dark aside a:hover,aside a:hover{background-color:var(--ws-orange-50)}.dark aside a:hover{background-color:rgba(255, 103, 25, 0.08)}button[class*=\"ai\"i],button[class*=\"ai\"i] *,button[class*=\"Ask\"i],button[class*=\"Ask\"i] *,[class*=\"AskAI\"],[class*=\"AskAI\"] *,header button[style*=\"background\"],header button[style*=\"background\"] *{color:#ffffff!important}[class*=\"method-post\"],.rm-MethodBadge--post{background-color:var(--ws-orange-500)!important;color:#ffffff!important}[class*=\"method-get\"]{background-color:#258895!important;color:#ffffff!important}[class*=\"method-put\"],[class*=\"method-patch\"]{background-color:#dd7702!important;color:#ffffff!important}[class*=\"method-delete\"]{background-color:#c73107!important;color:#ffffff!important}.card{border-radius:16px!important;border:1px solid rgba(32, 32, 32, 0.08)!important;background:#ffffff!important;box-shadow:none!important;--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-offset-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important;transition:border-color 180ms cubic-bezier(0.2, 0.7, 0.2, 1)!important}.card:hover{border-color:#ff6719!important;box-shadow:none!important;--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important}.dark .card{background:#2a2a2a!important;border-color:rgba(255, 255, 255, 0.08)!important}.dark .card:hover{border-color:#ff8337!important}.docs-home-body [class*=\"rounded-full\"][class*=\"size-7\"],.docs-home-body div.rounded-full{background:#ffffff!important;border:1.5px solid #ff6719!important;color:#ff6719!important;font-weight:600!important;box-shadow:0 1px 2px rgba(32, 32, 32, 0.04)}.dark .docs-home-body [class*=\"rounded-full\"][class*=\"size-7\"],.dark .docs-home-body div.rounded-full{background:#2a2a2a!important;border-color:#ff8337!important;color:#ff8337!important}.docs-home-body [class*=\"border-l\"],.docs-home-body div[class*=\"border-gray\"][class*=\"border-l\"]{border-left-color:rgba(32, 32, 32, 0.18)!important;border-left-width:1px!important}.dark .docs-home-body [class*=\"border-l\"],.dark .docs-home-body div[class*=\"border-gray\"][class*=\"border-l\"]{border-left-color:rgba(245, 244, 240, 0.18)!important}[class*=\"callout\"],.callout{border-radius:12px!important;border-left-width:3px!important}.prose table{border-collapse:separate;border-spacing:0;border-radius:12px;overflow:hidden;border:1px solid var(--ws-border);background:var(--ws-paper-white);font-size:0.94em}.dark .prose table{background:rgba(255, 255, 255, 0.02)}.prose thead{background:var(--ws-cream-100)}.dark .prose thead{background:rgba(255, 255, 255, 0.06)}.prose th,.prose td{padding:11px 16px;line-height:1.5;vertical-align:top}.prose th{font-weight:600;color:var(--ws-ink-black);letter-spacing:0.005em;border-bottom:1px solid var(--ws-border)}.dark .prose th{color:var(--ws-light-cream)}.prose tbody tr+tr>td{border-top:1px solid var(--ws-border)}.prose tbody tr:hover>td{background:rgba(32, 32, 32, 0.018)}.dark .prose tbody tr:hover>td{background:rgba(255, 255, 255, 0.03)}.prose tbody td:first-child{color:var(--ws-ink-black)}.dark .prose tbody td:first-child{color:var(--ws-light-cream)}.prose blockquote{border-left:3px solid var(--ws-sonic-orange)!important;background:var(--ws-orange-50);border-radius:0 12px 12px 0;font-style:normal}.dark .prose blockquote{background:rgba(255, 103, 25, 0.06)}*:focus-visible{outline:2px solid var(--ws-sonic-orange)!important;outline-offset:2px!important}.docs-hero{position:relative;overflow:hidden;background:#f5f4f0;padding:64px 24px 96px;margin-top:0;transition:background 200ms cubic-bezier(0.2, 0.7, 0.2, 1)}.dark .docs-hero{background:#202020}.docs-hero-inner{position:relative;max-width:880px;margin:0 auto;z-index:1;text-align:center}.docs-hero-eyebrow{display:inline-block;padding:6px 14px;border-radius:999px;background:rgba(255, 103, 25, 0.1);color:#9e280e;font-size:12px;font-weight:500;letter-spacing:0.08em;text-transform:uppercase;margin-bottom:28px}.dark .docs-hero-eyebrow{background:rgba(255, 103, 25, 0.18);color:#ffa46c}.docs-hero-headline{font-family:\"Roobert\", \"Inter\", system-ui, sans-serif;font-size:clamp(36px, 5.2vw, 60px);font-weight:600;line-height:1.1;letter-spacing:-0.04em;color:#202020;margin:0 auto;text-wrap:balance;max-width:820px}.dark .docs-hero-headline{color:#f5f4f0}.docs-hero-sub{font-family:\"Roobert\", \"Inter\", system-ui, sans-serif;font-size:clamp(16px, 1.2vw, 19px);line-height:1.55;margin:24px auto 0;max-width:620px;color:#3d3d3d}.dark .docs-hero-sub{color:#c6c0ab}.docs-hero-cta-row{margin-top:36px;display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.docs-hero-cta-primary{background:#ff6719;color:#ffffff!important;padding:12px 22px;border-radius:10px;font-weight:500;font-size:15px;text-decoration:none!important;display:inline-flex;align-items:center;gap:6px;transition:background 200ms cubic-bezier(0.2, 0.7, 0.2, 1)}.docs-hero-cta-primary:hover{background:#fd4606;color:#ffffff!important}.docs-hero-cta-ghost{background:transparent;color:#202020!important;padding:12px 22px;border-radius:10px;font-weight:500;font-size:15px;text-decoration:none!important;display:inline-flex;align-items:center;gap:6px;border:1px solid rgba(32, 32, 32, 0.18);transition:border-color 200ms cubic-bezier(0.2, 0.7, 0.2, 1)}.docs-hero-cta-ghost:hover{border-color:#ff6719;color:#ffffff!important}.dark .docs-hero-cta-ghost{color:#f5f4f0!important;border-color:rgba(245, 244, 240, 0.22)}.dark .docs-hero-cta-ghost:hover{border-color:#ff6719;color:#ffffff!important}.docs-hero-lines{position:absolute;bottom:-100px;width:1180px;max-width:none;opacity:0.7;pointer-events:none}.docs-hero-lines.left{left:-360px}.docs-hero-lines.right{right:-360px}.dark .docs-hero-lines{opacity:0.18;filter:invert(1) hue-rotate(180deg) brightness(0.85)}.docs-hero-ailogo{display:inline-flex;align-items:center;justify-content:center;width:0.92em;height:0.92em;margin:0 0.16em -0.08em;background:#ffffff;border-radius:10px;box-shadow:0px 0px 6.36px 0px rgba(255, 103, 25, 0.3);vertical-align:baseline;position:relative;overflow:hidden;flex-shrink:0}.dark .docs-hero-ailogo{background:#ffffff;box-shadow:0px 0px 12px 0px rgba(255, 103, 25, 0.45)}.docs-hero-ailogo>span,.docs-hero-ailogo>span[data-rmiz]{position:absolute!important;top:50%;left:50%;width:64%;height:64%;transform:translate(-50%, calc(-50% + 14px));opacity:0;animation:docs-ai-rotate 7500ms cubic-bezier(0.22, 0.7, 0.2, 1) infinite;display:flex;align-items:center;justify-content:center;pointer-events:none}.docs-hero-ailogo [data-rmiz-content],.docs-hero-ailogo [data-rmiz-content=\"found\"]{display:flex!important;width:100%;height:100%;align-items:center;justify-content:center}.docs-hero-ailogo img{width:100%!important;height:100%!important;object-fit:contain;position:static!important;border-radius:0!important;border:none!important;background:none!important}.docs-hero-ailogo [data-rmiz-ghost],.docs-hero-ailogo [data-rmiz-btn-zoom],.docs-hero-ailogo button{display:none!important;pointer-events:none!important}@keyframes docs-ai-rotate{0%{opacity:0;transform:translate(-50%, calc(-50% + 14px))}3.33%{opacity:1;transform:translate(-50%, -50%)}13.33%{opacity:1;transform:translate(-50%, -50%)}16.67%{opacity:0;transform:translate(-50%, calc(-50% - 14px))}100%{opacity:0;transform:translate(-50%, calc(-50% - 14px))}}.docs-hero-ailogo>span:nth-of-type(1){animation-delay:0ms}.docs-hero-ailogo>span:nth-of-type(2){animation-delay:1250ms}.docs-hero-ailogo>span:nth-of-type(3){animation-delay:2500ms}.docs-hero-ailogo>span:nth-of-type(4){animation-delay:3750ms}.docs-hero-ailogo>span:nth-of-type(5){animation-delay:5000ms}.docs-hero-ailogo>span:nth-of-type(6){animation-delay:6250ms}@media (prefers-reduced-motion: reduce){.docs-hero-ailogo>span{animation:none;opacity:0}.docs-hero-ailogo>span:nth-of-type(1){opacity:1;transform:translate(-50%, -50%)}}.docs-home-body{max-width:1120px;margin:0 auto;padding:0 24px}.docs-home-section{padding:80px 0 24px;border-bottom:1px solid rgba(32, 32, 32, 0.14)}.docs-home-section-last{border-bottom:0;padding-bottom:120px}.dark .docs-home-section{border-bottom-color:rgba(245, 244, 240, 0.14)}.dark .docs-home-section-last{border-bottom:0}.docs-home-eyebrow{font-size:15px;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;color:#ff6719;margin-bottom:18px}.docs-home-h2{font-family:\"Roobert\", \"Inter\", system-ui, sans-serif;font-weight:600;font-size:clamp(28px, 3vw, 40px);line-height:1.15;letter-spacing:-0.03em;color:#202020;margin:0 0 16px;max-width:800px;text-wrap:balance}.dark .docs-home-h2{color:#f5f4f0}.docs-home-lede{font-family:\"Roobert\", \"Inter\", system-ui, sans-serif;font-size:clamp(16px, 1.1vw, 18px);line-height:1.55;color:#5c5c5c;margin:0 0 36px;max-width:720px}.dark .docs-home-lede{color:#c6c0ab}img[src=\"/images/logo/logo-light.svg\"],img[src=\"/images/logo/logo-dark.svg\"],img[alt=\"light logo\"],img[alt=\"dark logo\"]{height:14px!important;width:auto!important;max-height:14px!important}::-webkit-scrollbar{width:10px;height:10px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{background:var(--ws-cream-200);border-radius:8px}.dark ::-webkit-scrollbar-thumb{background:rgba(255, 255, 255, 0.1)}::-webkit-scrollbar-thumb:hover{background:var(--ws-orange-300)}"}],"page":{"pagePath":"api-reference/generic/get-all-citations","slug":"/api-reference/generic/get-all-citations","pageMetadata":{"title":"Get All Citations","description":"List individual citation records (URL, domain, title) found in AI responses.\n\n**Example:** \"Show all citations from wikipedia.org.\" Unlike `/reports/citations` which returns aggregated counts, this returns raw citation rows.\n\n**Metrics** (optional): `citation_share`, `citing_answers`, `citing_answers_mentioning_you`, `visibility_contribution`, `source_type`, `platforms`, `topics`, `content_last_cited`. Omit for the plain listing. Any metric switches to the dashboard's All Citations engine, so values match the app exactly; with `comparison_start_date` / `comparison_end_date` the numeric metrics also carry `previous_\u003cmetric>`.\n\n**Filters:** `topics`, `prompts`, `tags`, `markets`, `intent`, `branded`, `platform`, `has_shopping_card`, `visibility`, `rank`, `website_mentioned_in_answer`, `cited_page_url`, `cited_domain`, `website_mentioned_in_citation`, `domain`, `url`, `path`. With metrics: `path`, `rank`, `visibility`, `has_shopping_card` and tree-style `advanced_filters` are not supported (400), because the All Citations engine does not evaluate them; `platform` values naming a model widen to that model's provider.\n\n**Sort fields:** `domain`, `url`, `title` for the listing; with metrics, any numeric metric or `content_last_cited`.\n\n**Dates:** Defaults to all-time when no dates provided.\n\n**Filter values:** `markets` takes a market id or `contains` with a region code such as `us` (names like `United States` and labels like `us - en` match nothing); `tags`, `topics` and `platform` match by name or id.\n\n**Pagination:** Use `pagination` (`limit` 1-100, default 10; `offset` for paging). Use `order_by` for sorting.\n\n**Response:** Returns `data` array with `info` metadata containing `total_rows` (before pagination) and `query` (applied metrics, dates, sorting, pagination, filters).","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/citations","href":"/api-reference/generic/get-all-citations","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"List individual citation records (URL, domain, title) found in AI responses.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Example:\"\n }), \" “Show all citations from wikipedia.org.” Unlike \", _jsx(_components.code, {\n children: \"/reports/citations\"\n }), \" which returns aggregated counts, this returns raw citation rows.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Metrics\"\n }), \" (optional): \", _jsx(_components.code, {\n children: \"citation_share\"\n }), \", \", _jsx(_components.code, {\n children: \"citing_answers\"\n }), \", \", _jsx(_components.code, {\n children: \"citing_answers_mentioning_you\"\n }), \", \", _jsx(_components.code, {\n children: \"visibility_contribution\"\n }), \", \", _jsx(_components.code, {\n children: \"source_type\"\n }), \", \", _jsx(_components.code, {\n children: \"platforms\"\n }), \", \", _jsx(_components.code, {\n children: \"topics\"\n }), \", \", _jsx(_components.code, {\n children: \"content_last_cited\"\n }), \". Omit for the plain listing. Any metric switches to the dashboard’s All Citations engine, so values match the app exactly; with \", _jsx(_components.code, {\n children: \"comparison_start_date\"\n }), \" / \", _jsx(_components.code, {\n children: \"comparison_end_date\"\n }), \" the numeric metrics also carry \", _jsx(_components.code, {\n children: \"previous_\u003cmetric>\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Filters:\"\n }), \" \", _jsx(_components.code, {\n children: \"topics\"\n }), \", \", _jsx(_components.code, {\n children: \"prompts\"\n }), \", \", _jsx(_components.code, {\n children: \"tags\"\n }), \", \", _jsx(_components.code, {\n children: \"markets\"\n }), \", \", _jsx(_components.code, {\n children: \"intent\"\n }), \", \", _jsx(_components.code, {\n children: \"branded\"\n }), \", \", _jsx(_components.code, {\n children: \"platform\"\n }), \", \", _jsx(_components.code, {\n children: \"has_shopping_card\"\n }), \", \", _jsx(_components.code, {\n children: \"visibility\"\n }), \", \", _jsx(_components.code, {\n children: \"rank\"\n }), \", \", _jsx(_components.code, {\n children: \"website_mentioned_in_answer\"\n }), \", \", _jsx(_components.code, {\n children: \"cited_page_url\"\n }), \", \", _jsx(_components.code, {\n children: \"cited_domain\"\n }), \", \", _jsx(_components.code, {\n children: \"website_mentioned_in_citation\"\n }), \", \", _jsx(_components.code, {\n children: \"domain\"\n }), \", \", _jsx(_components.code, {\n children: \"url\"\n }), \", \", _jsx(_components.code, {\n children: \"path\"\n }), \". With metrics: \", _jsx(_components.code, {\n children: \"path\"\n }), \", \", _jsx(_components.code, {\n children: \"rank\"\n }), \", \", _jsx(_components.code, {\n children: \"visibility\"\n }), \", \", _jsx(_components.code, {\n children: \"has_shopping_card\"\n }), \" and tree-style \", _jsx(_components.code, {\n children: \"advanced_filters\"\n }), \" are not supported (400), because the All Citations engine does not evaluate them; \", _jsx(_components.code, {\n children: \"platform\"\n }), \" values naming a model widen to that model’s provider.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Sort fields:\"\n }), \" \", _jsx(_components.code, {\n children: \"domain\"\n }), \", \", _jsx(_components.code, {\n children: \"url\"\n }), \", \", _jsx(_components.code, {\n children: \"title\"\n }), \" for the listing; with metrics, any numeric metric or \", _jsx(_components.code, {\n children: \"content_last_cited\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Dates:\"\n }), \" Defaults to all-time when no dates provided.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Filter values:\"\n }), \" \", _jsx(_components.code, {\n children: \"markets\"\n }), \" takes a market id or \", _jsx(_components.code, {\n children: \"contains\"\n }), \" with a region code such as \", _jsx(_components.code, {\n children: \"us\"\n }), \" (names like \", _jsx(_components.code, {\n children: \"United States\"\n }), \" and labels like \", _jsx(_components.code, {\n children: \"us - en\"\n }), \" match nothing); \", _jsx(_components.code, {\n children: \"tags\"\n }), \", \", _jsx(_components.code, {\n children: \"topics\"\n }), \" and \", _jsx(_components.code, {\n children: \"platform\"\n }), \" match by name or id.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Pagination:\"\n }), \" Use \", _jsx(_components.code, {\n children: \"pagination\"\n }), \" (\", _jsx(_components.code, {\n children: \"limit\"\n }), \" 1-100, default 10; \", _jsx(_components.code, {\n children: \"offset\"\n }), \" for paging). Use \", _jsx(_components.code, {\n children: \"order_by\"\n }), \" for sorting.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Response:\"\n }), \" Returns \", _jsx(_components.code, {\n children: \"data\"\n }), \" array with \", _jsx(_components.code, {\n children: \"info\"\n }), \" metadata containing \", _jsx(_components.code, {\n children: \"total_rows\"\n }), \" (before pagination) and \", _jsx(_components.code, {\n children: \"query\"\n }), \" (applied metrics, dates, sorting, pagination, filters).\"]\n })]\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get All Citations","description":"List individual citation records (URL, domain, title) found in AI responses.\n\n**Example:** \"Show all citations from wikipedia.org.\" Unlike `/reports/citations` which returns aggregated counts, this returns raw citation rows.\n\n**Metrics** (optional): `citation_share`, `citing_answers`, `citing_answers_mentioning_you`, `visibility_contribution`, `source_type`, `platforms`, `topics`, `content_last_cited`. Omit for the plain listing. Any metric switches to the dashboard's All Citations engine, so values match the app exactly; with `comparison_start_date` / `comparison_end_date` the numeric metrics also carry `previous_\u003cmetric>`.\n\n**Filters:** `topics`, `prompts`, `tags`, `markets`, `intent`, `branded`, `platform`, `has_shopping_card`, `visibility`, `rank`, `website_mentioned_in_answer`, `cited_page_url`, `cited_domain`, `website_mentioned_in_citation`, `domain`, `url`, `path`. With metrics: `path`, `rank`, `visibility`, `has_shopping_card` and tree-style `advanced_filters` are not supported (400), because the All Citations engine does not evaluate them; `platform` values naming a model widen to that model's provider.\n\n**Sort fields:** `domain`, `url`, `title` for the listing; with metrics, any numeric metric or `content_last_cited`.\n\n**Dates:** Defaults to all-time when no dates provided.\n\n**Filter values:** `markets` takes a market id or `contains` with a region code such as `us` (names like `United States` and labels like `us - en` match nothing); `tags`, `topics` and `platform` match by name or id.\n\n**Pagination:** Use `pagination` (`limit` 1-100, default 10; `offset` for paging). Use `order_by` for sorting.\n\n**Response:** Returns `data` array with `info` metadata containing `total_rows` (before pagination) and `query` (applied metrics, dates, sorting, pagination, filters).","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/citations","href":"/api-reference/generic/get-all-citations","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Generic"],"summary":"Get All Citations","description":"List individual citation records (URL, domain, title) found in AI responses.\n\n**Example:** \"Show all citations from wikipedia.org.\" Unlike `/reports/citations` which returns aggregated counts, this returns raw citation rows.\n\n**Metrics** (optional): `citation_share`, `citing_answers`, `citing_answers_mentioning_you`, `visibility_contribution`, `source_type`, `platforms`, `topics`, `content_last_cited`. Omit for the plain listing. Any metric switches to the dashboard's All Citations engine, so values match the app exactly; with `comparison_start_date` / `comparison_end_date` the numeric metrics also carry `previous_\u003cmetric>`.\n\n**Filters:** `topics`, `prompts`, `tags`, `markets`, `intent`, `branded`, `platform`, `has_shopping_card`, `visibility`, `rank`, `website_mentioned_in_answer`, `cited_page_url`, `cited_domain`, `website_mentioned_in_citation`, `domain`, `url`, `path`. With metrics: `path`, `rank`, `visibility`, `has_shopping_card` and tree-style `advanced_filters` are not supported (400), because the All Citations engine does not evaluate them; `platform` values naming a model widen to that model's provider.\n\n**Sort fields:** `domain`, `url`, `title` for the listing; with metrics, any numeric metric or `content_last_cited`.\n\n**Dates:** Defaults to all-time when no dates provided.\n\n**Filter values:** `markets` takes a market id or `contains` with a region code such as `us` (names like `United States` and labels like `us - en` match nothing); `tags`, `topics` and `platform` match by name or id.\n\n**Pagination:** Use `pagination` (`limit` 1-100, default 10; `offset` for paging). Use `order_by` for sorting.\n\n**Response:** Returns `data` array with `info` metadata containing `total_rows` (before pagination) and `query` (applied metrics, dates, sorting, pagination, filters).","operationId":"get_all_citation_reports","requestBody":"97cb92a8-fc0d-468b-8d25-b3ef48aee6e4","responses":{"200":"2cfd6b2c-c7e0-47c0-9d2d-075c3f9635c5","422":"1bcff58e-6e54-46fc-a26f-eb834fc9891b"},"security":["9d8eda2e-997a-44ad-af32-9f75bbb06065"],"method":"post","type":"path","servers":["e2516a54-c064-424d-91ff-7b7645d759f6"],"path":"/v2/geo/business/citations","baseUrlOptions":["https://api.writesonic.com"],"title":"Get All Citations","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"project_id":{"type":"string","minLength":1,"title":"Project Id","description":"Unique identifier of the project to query. Get valid project IDs from get_all_projects.","examples":["550e8400-e29b-41d4-a716-446655440000"],"isRequired":true,"uniqueKey":"project_id","typeLabel":"string"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start of the date range (ISO 8601). Limits results to data collected on or after this date. When omitted: defaults to the latest run's start date for metric queries, or earliest available date for list queries.","examples":["2026-01-01T00:00:00Z","2026-03-01T00:00:00Z"],"uniqueKey":"start_date","typeLabel":"string\u003cdate-time>"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End of the date range (ISO 8601). Limits results to data collected on or before this date. When omitted: defaults to today. Date-only strings (no 'T') are extended to end of day.","examples":["2026-01-31T23:59:59Z","2026-03-17T23:59:59Z"],"uniqueKey":"end_date","typeLabel":"string\u003cdate-time>"},"current_from":{"type":"string","format":"date-time","title":"Current From","description":"Alias for start_date (analytics-tool date naming).","uniqueKey":"current_from","typeLabel":"string\u003cdate-time>"},"current_to":{"type":"string","format":"date-time","title":"Current To","description":"Alias for end_date (analytics-tool date naming).","uniqueKey":"current_to","typeLabel":"string\u003cdate-time>"},"comparison_start_date":{"type":"string","format":"date-time","title":"Comparison Start Date","description":"Start of the comparison (past) date range (ISO 8601). Provide together with comparison_end_date to additionally compute every measure over this past range — each row then includes previous_\u003cmeasure> values calculated with identical dimensions, measures, and filters.","examples":["2026-07-25T00:00:00Z"],"uniqueKey":"comparison_start_date","typeLabel":"string\u003cdate-time>"},"comparison_end_date":{"type":"string","format":"date-time","title":"Comparison End Date","description":"End of the comparison (past) date range (ISO 8601). Required together with comparison_start_date. Date-only strings (no 'T') are extended to end of day, same as end_date.","examples":["2026-07-31T23:59:59Z"],"uniqueKey":"comparison_end_date","typeLabel":"string\u003cdate-time>"},"previous_from":{"type":"string","format":"date-time","title":"Previous From","description":"Alias for comparison_start_date (analytics-tool date naming).","uniqueKey":"previous_from","typeLabel":"string\u003cdate-time>"},"previous_to":{"type":"string","format":"date-time","title":"Previous To","description":"Alias for comparison_end_date (analytics-tool date naming).","uniqueKey":"previous_to","typeLabel":"string\u003cdate-time>"},"order_by":{"items":{"properties":{"field":{"type":"string","title":"Field","description":"Field name to sort by. Must match a measure or dimension name from the response (e.g., 'visibility_score', 'mention_count', 'topic_name').","examples":["visibility_score","mention_count","rank"],"isRequired":true,"uniqueKey":"order_by.items.[INDEX].field","typeLabel":"string"},"order":{"type":"string","enum":["asc","desc"],"title":"SortOrderType","description":"Sort direction: 'asc' (lowest first) or 'desc' (highest first).","x-enumDescriptions":{"asc":"Ascending order (lowest first, A-Z, oldest first)","desc":"Descending order (highest first, Z-A, newest first)"},"examples":["desc"],"isRequired":true,"uniqueKey":"order_by.items.[INDEX].order","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"type":"object","required":["field","order"],"title":"SortingOrder","description":"Sort results by a specific field. Use with `order_by` to control result ordering — e.g., sort by visibility score descending to see top performers first.","uniqueKey":"order_by.items.[INDEX]","typeLabel":"SortingOrder · object"},"type":"array","title":"Order By","description":"Sort results by one or more fields. Each entry specifies a field name and direction. Results are sorted by the first entry, then ties broken by subsequent entries.","examples":[[{"field":"visibility_score","order":"desc"}],[{"field":"mention_count","order":"desc"},{"field":"rank","order":"asc"}]],"uniqueKey":"order_by","typeLabel":"SortingOrder · object[]"},"pagination":{"properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Number of items per page (1-100). Use smaller values for faster responses.","default":10,"examples":[10,25,50],"uniqueKey":"pagination.limit","typeLabel":"integer"},"offset":{"type":"integer","minimum":0,"title":"Offset","description":"Number of items to skip. Set to `limit * page_number` for page-based navigation.","default":0,"examples":[0,10,50],"uniqueKey":"pagination.offset","typeLabel":"integer"}},"additionalProperties":false,"type":"object","title":"PaginationInput","description":"Control result pagination. Set `limit` for page size and `offset` to skip results. Omit to return all results (use with caution on large datasets).","examples":[{"limit":10,"offset":0},{"limit":25,"offset":50}],"uniqueKey":"pagination","typeLabel":"PaginationInput · object"},"metrics":{"items":{"type":"string","enum":["citation_share","citing_answers","citing_answers_mentioning_you","visibility_contribution","source_type","platforms","topics","content_last_cited"],"title":"CitationMetric","description":"Per-citation metrics, computed exactly as the dashboard's All Citations page does.\n\n- `citation_share`: % of answers in range that cite this page (citing_answers / answers)\n- `citing_answers`: Answers in range that cite this page\n- `citing_answers_mentioning_you`: Of those, answers that also mention your brand\n- `visibility_contribution`: % of your brand mentions that came from answers citing this page\n- `source_type`: owned | competitor | social_forums | third_party\n- `platforms`: AI platforms whose answers cited this page\n- `topics`: Topics of the prompts whose answers cited this page\n- `content_last_cited`: Most recent time an answer cited this page","x-enumDescriptions":{"citation_share":"% of answers in range that cite this page (citing_answers / answers)","citing_answers":"Answers in range that cite this page","citing_answers_mentioning_you":"Of those, answers that also mention your brand","content_last_cited":"Most recent time an answer cited this page","platforms":"AI platforms whose answers cited this page","source_type":"owned | competitor | social_forums | third_party","topics":"Topics of the prompts whose answers cited this page","visibility_contribution":"% of your brand mentions that came from answers citing this page"},"uniqueKey":"metrics.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Metrics","description":"Metrics to include per citation. Omit for the plain listing. Any metric switches to the dashboard's citation engine; with comparison dates, numeric metrics also get `previous_\u003cmetric>`.","examples":[["citation_share","citing_answers","source_type"]],"uniqueKey":"metrics","typeLabel":"enum\u003cstring>[]"},"filters":{"properties":{"topics":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.topics.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.topics.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.topics.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.topics.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.topics.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by topic ID or topic name.","examples":[{"condition":"OR","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]}],"uniqueKey":"filters.topics","typeLabel":"StringFilterGroup · object"},"prompts":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.prompts.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.prompts.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.prompts.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.prompts.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.prompts.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by prompt ID or query text. Use 'contains' for partial text matching.","examples":[{"condition":"AND","items":[{"operator":"contains","value":"best AI tools"}]}],"uniqueKey":"filters.prompts","typeLabel":"StringFilterGroup · object"},"tags":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.tags.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.tags.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.tags.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.tags.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.tags.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by tag ID or tag name. 'is' checks tag association, 'is_not' excludes.","examples":[{"condition":"OR","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"}]}],"uniqueKey":"filters.tags","typeLabel":"StringFilterGroup · object"},"markets":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.markets.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.markets.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.markets.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.markets.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.markets.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by market ID or region name (e.g., 'United States').","examples":[{"condition":"OR","items":[{"operator":"is","value":"United States"},{"operator":"is","value":"United Kingdom"}]}],"uniqueKey":"filters.markets","typeLabel":"StringFilterGroup · object"},"intent":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.intent.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.intent.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.intent.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.intent.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.intent.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by search intent: 'transactional', 'navigational', 'informational', 'commercial'.","examples":[{"condition":"OR","items":[{"operator":"is","value":"informational"},{"operator":"is","value":"commercial"}]}],"uniqueKey":"filters.intent","typeLabel":"StringFilterGroup · object"},"branded":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["AND"],"uniqueKey":"filters.branded.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not"],"title":"BooleanOperator","description":"'is' (match value) or 'is_not' (exclude value)","x-enumDescriptions":{"is":"Match rows where the field equals the boolean value","is_not":"Match rows where the field does not equal the boolean value"},"examples":["is"],"isRequired":true,"uniqueKey":"filters.branded.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"Boolean value: true or false.","examples":[true,false],"uniqueKey":"filters.branded.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"BooleanFilterCondition","description":"A single boolean filter condition.\n\nOperators:\n- `is` — Match value. Example: {\"operator\": \"is\", \"value\": true}\n- `is_not` — Exclude value.","uniqueKey":"filters.branded.\\items.items.[INDEX]","typeLabel":"BooleanFilterCondition · object"},"type":"array","title":"Items","description":"List of boolean filter conditions to apply.","examples":[[{"operator":"is","value":true}]],"uniqueKey":"filters.branded.\\items","typeLabel":"BooleanFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"BooleanFilterGroup","description":"true = branded queries only, false = non-branded only.","examples":[{"condition":"AND","items":[{"operator":"is","value":false}]}],"uniqueKey":"filters.branded","typeLabel":"BooleanFilterGroup · object"},"platform":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.platform.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.platform.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.platform.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.platform.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.platform.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by AI platform name (e.g., 'ChatGPT', 'Perplexity', 'Gemini'). Use 'contains' for partial matches.","examples":[{"condition":"OR","items":[{"operator":"is","value":"ChatGPT"},{"operator":"is","value":"Perplexity"}]}],"uniqueKey":"filters.platform","typeLabel":"StringFilterGroup · object"},"has_shopping_card":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["AND"],"uniqueKey":"filters.has_shopping_card.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not"],"title":"BooleanOperator","description":"'is' (match value) or 'is_not' (exclude value)","x-enumDescriptions":{"is":"Match rows where the field equals the boolean value","is_not":"Match rows where the field does not equal the boolean value"},"examples":["is"],"isRequired":true,"uniqueKey":"filters.has_shopping_card.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"Boolean value: true or false.","examples":[true,false],"uniqueKey":"filters.has_shopping_card.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"BooleanFilterCondition","description":"A single boolean filter condition.\n\nOperators:\n- `is` — Match value. Example: {\"operator\": \"is\", \"value\": true}\n- `is_not` — Exclude value.","uniqueKey":"filters.has_shopping_card.\\items.items.[INDEX]","typeLabel":"BooleanFilterCondition · object"},"type":"array","title":"Items","description":"List of boolean filter conditions to apply.","examples":[[{"operator":"is","value":true}]],"uniqueKey":"filters.has_shopping_card.\\items","typeLabel":"BooleanFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"BooleanFilterGroup","description":"true = only responses with shopping cards.","examples":[{"condition":"AND","items":[{"operator":"is","value":true}]}],"uniqueKey":"filters.has_shopping_card","typeLabel":"BooleanFilterGroup · object"},"has_ads_data":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["AND"],"uniqueKey":"filters.has_ads_data.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not"],"title":"BooleanOperator","description":"'is' (match value) or 'is_not' (exclude value)","x-enumDescriptions":{"is":"Match rows where the field equals the boolean value","is_not":"Match rows where the field does not equal the boolean value"},"examples":["is"],"isRequired":true,"uniqueKey":"filters.has_ads_data.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"Boolean value: true or false.","examples":[true,false],"uniqueKey":"filters.has_ads_data.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"BooleanFilterCondition","description":"A single boolean filter condition.\n\nOperators:\n- `is` — Match value. Example: {\"operator\": \"is\", \"value\": true}\n- `is_not` — Exclude value.","uniqueKey":"filters.has_ads_data.\\items.items.[INDEX]","typeLabel":"BooleanFilterCondition · object"},"type":"array","title":"Items","description":"List of boolean filter conditions to apply.","examples":[[{"operator":"is","value":true}]],"uniqueKey":"filters.has_ads_data.\\items","typeLabel":"BooleanFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"BooleanFilterGroup","description":"true = only responses that include sponsored / ad placements.","examples":[{"condition":"AND","items":[{"operator":"is","value":true}]}],"uniqueKey":"filters.has_ads_data","typeLabel":"BooleanFilterGroup · object"},"visibility":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["AND"],"uniqueKey":"filters.visibility.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["eq","neq","gt","gte","lt","lte"],"title":"NumericOperator","description":"'eq' (=), 'neq' (!=), 'gt' (>), 'gte' (>=), 'lt' (\u003c), 'lte' (\u003c=)","x-enumDescriptions":{"eq":"Equal to (=)","gt":"Greater than (>)","gte":"Greater than or equal to (>=)","lt":"Less than (\u003c)","lte":"Less than or equal to (\u003c=)","neq":"Not equal to (!=)"},"examples":["gte","lte","eq"],"isRequired":true,"uniqueKey":"filters.visibility.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"Numeric value to compare against (integer or float).","examples":[50,3,0.75],"uniqueKey":"filters.visibility.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"NumericFilterCondition","description":"A single numeric filter condition for range-based filtering.\n\nOperators:\n- `eq` (=), `neq` (not equal), `gt` (>), `gte` (>=), `lt` (\u003c), `lte` (\u003c=)\n\nExample: {\"operator\": \"gte\", \"value\": 50}","uniqueKey":"filters.visibility.\\items.items.[INDEX]","typeLabel":"NumericFilterCondition · object"},"type":"array","title":"Items","description":"List of numeric filter conditions to apply.","examples":[[{"operator":"gte","value":50}]],"uniqueKey":"filters.visibility.\\items","typeLabel":"NumericFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"NumericFilterGroup","description":"Keep only answers where your brand's mention has this visibility score (0-100).","examples":[{"condition":"AND","items":[{"operator":"gte","value":50}]}],"uniqueKey":"filters.visibility","typeLabel":"NumericFilterGroup · object"},"rank":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["AND"],"uniqueKey":"filters.rank.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["eq","neq","gt","gte","lt","lte"],"title":"NumericOperator","description":"'eq' (=), 'neq' (!=), 'gt' (>), 'gte' (>=), 'lt' (\u003c), 'lte' (\u003c=)","x-enumDescriptions":{"eq":"Equal to (=)","gt":"Greater than (>)","gte":"Greater than or equal to (>=)","lt":"Less than (\u003c)","lte":"Less than or equal to (\u003c=)","neq":"Not equal to (!=)"},"examples":["gte","lte","eq"],"isRequired":true,"uniqueKey":"filters.rank.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"Numeric value to compare against (integer or float).","examples":[50,3,0.75],"uniqueKey":"filters.rank.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"NumericFilterCondition","description":"A single numeric filter condition for range-based filtering.\n\nOperators:\n- `eq` (=), `neq` (not equal), `gt` (>), `gte` (>=), `lt` (\u003c), `lte` (\u003c=)\n\nExample: {\"operator\": \"gte\", \"value\": 50}","uniqueKey":"filters.rank.\\items.items.[INDEX]","typeLabel":"NumericFilterCondition · object"},"type":"array","title":"Items","description":"List of numeric filter conditions to apply.","examples":[[{"operator":"gte","value":50}]],"uniqueKey":"filters.rank.\\items","typeLabel":"NumericFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"NumericFilterGroup","description":"Keep only answers where your brand is mentioned at this rank position (1-99, lower is better).","examples":[{"condition":"AND","items":[{"operator":"lte","value":3}]}],"uniqueKey":"filters.rank","typeLabel":"NumericFilterGroup · object"},"volume":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["AND"],"uniqueKey":"filters.volume.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["eq","neq","gt","gte","lt","lte"],"title":"NumericOperator","description":"'eq' (=), 'neq' (!=), 'gt' (>), 'gte' (>=), 'lt' (\u003c), 'lte' (\u003c=)","x-enumDescriptions":{"eq":"Equal to (=)","gt":"Greater than (>)","gte":"Greater than or equal to (>=)","lt":"Less than (\u003c)","lte":"Less than or equal to (\u003c=)","neq":"Not equal to (!=)"},"examples":["gte","lte","eq"],"isRequired":true,"uniqueKey":"filters.volume.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"Numeric value to compare against (integer or float).","examples":[50,3,0.75],"uniqueKey":"filters.volume.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"NumericFilterCondition","description":"A single numeric filter condition for range-based filtering.\n\nOperators:\n- `eq` (=), `neq` (not equal), `gt` (>), `gte` (>=), `lt` (\u003c), `lte` (\u003c=)\n\nExample: {\"operator\": \"gte\", \"value\": 50}","uniqueKey":"filters.volume.\\items.items.[INDEX]","typeLabel":"NumericFilterCondition · object"},"type":"array","title":"Items","description":"List of numeric filter conditions to apply.","examples":[[{"operator":"gte","value":50}]],"uniqueKey":"filters.volume.\\items","typeLabel":"NumericFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"NumericFilterGroup","description":"Filter by prompt monthly search volume. Prompts without a known volume never match.","examples":[{"condition":"AND","items":[{"operator":"gte","value":1000}]}],"uniqueKey":"filters.volume","typeLabel":"NumericFilterGroup · object"},"website_mentioned_in_answer":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.website_mentioned_in_answer.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.website_mentioned_in_answer.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.website_mentioned_in_answer.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.website_mentioned_in_answer.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.website_mentioned_in_answer.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by a tracked website (your brand or a competitor) mentioned in the AI response body: website ID or domain. 'contains' matches a substring of the domain. A value that matches no tracked website selects nothing.","examples":[{"condition":"AND","items":[{"operator":"contains","value":"writesonic.com"}]}],"uniqueKey":"filters.website_mentioned_in_answer","typeLabel":"StringFilterGroup · object"},"cited_page_url":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.cited_page_url.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.cited_page_url.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.cited_page_url.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.cited_page_url.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.cited_page_url.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by cited page URL. Use 'contains' for partial matching.","examples":[{"condition":"AND","items":[{"operator":"contains","value":"/blog/"}]}],"uniqueKey":"filters.cited_page_url","typeLabel":"StringFilterGroup · object"},"cited_domain":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.cited_domain.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.cited_domain.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.cited_domain.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.cited_domain.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.cited_domain.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by cited domain name (e.g., 'writesonic.com').","examples":[{"condition":"AND","items":[{"operator":"is","value":"writesonic.com"}]}],"uniqueKey":"filters.cited_domain","typeLabel":"StringFilterGroup · object"},"website_mentioned_in_citation":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.website_mentioned_in_citation.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.website_mentioned_in_citation.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.website_mentioned_in_citation.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.website_mentioned_in_citation.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.website_mentioned_in_citation.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"Filter by a tracked website whose pages are cited: website ID or domain. 'contains' matches a substring of the domain. A value that matches no tracked website selects nothing.","examples":[{"condition":"AND","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"}]}],"uniqueKey":"filters.website_mentioned_in_citation","typeLabel":"StringFilterGroup · object"},"advanced_filters":{"properties":{"join":{"type":"string","enum":["and","or"],"title":"Join","description":"'and' = all children must match, 'or' = any child.","default":"and","uniqueKey":"filters.advanced_filters.join","typeLabel":"enum\u003cstring>"},"conditions":{"items":{"oneOf":[{},{"type":"object","title":"ReportFilterLeaf","description":"A single condition inside an `advanced_filters` tree.\n\nThe operator must fit the field: text/id fields take `is`, `is_not`,\n`contains`, `not_contains`; boolean fields (`branded`, `has_shopping_card`)\ntake `is`, `is_not` with true/false; numeric fields (`volume`, `sentiment`)\ntake `eq`, `neq`, `gt`, `gte`, `lt`, `lte` with a number. Anything else is\nrejected with 422 instead of being silently ignored.","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["topics","prompts","tags","markets","intent","branded","platform","has_shopping_card","website_mentioned_in_answer","cited_page_url","cited_domain","website_mentioned_in_citation","volume","sentiment"],"title":"ReportFilterField","description":"A filter field usable as a leaf inside `advanced_filters`.","isRequired":true,"uniqueKey":"filters.advanced_filters.conditions.items.[INDEX].oneOf.1.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","title":"Operator","description":"'is' | 'is_not' | 'contains' | 'not_contains' for text/id fields; 'is' | 'is_not' for booleans; 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' for numeric fields (volume, sentiment).","isRequired":true,"uniqueKey":"filters.advanced_filters.conditions.items.[INDEX].oneOf.1.operator","typeLabel":"string"},"value":{"title":"Value","description":"The value to match against (required).","isRequired":true,"uniqueKey":"filters.advanced_filters.conditions.items.[INDEX].oneOf.1.value","typeLabel":"any"}},"additionalProperties":false,"uniqueKey":"filters.advanced_filters.conditions.items.[INDEX].oneOf.1","typeLabel":"ReportFilterLeaf · object"}],"uniqueKey":"filters.advanced_filters.conditions.items.[INDEX]","typeLabel":"ReportFilterLeaf · object"},"type":"array","title":"Conditions","description":"Child nodes: nested trees or leaf conditions. Empty = no advanced filter.","uniqueKey":"filters.advanced_filters.conditions","typeLabel":"ReportFilterLeaf · object[]"}},"additionalProperties":false,"type":"object","title":"ReportFilterTree","description":"Arbitrary AND/OR tree across any filter fields. When set, it takes precedence over the flat per-field filters above and is the only way to express cross-field OR, e.g. (topic is SEO) OR (platform is Grok).","examples":[{"conditions":[{"field":"topics","operator":"is","value":"\u003ctopic-id>"},{"field":"platform","operator":"is","value":"Grok"}],"join":"or"}],"uniqueKey":"filters.advanced_filters","typeLabel":"ReportFilterTree · object"},"domain":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.domain.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.domain.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.domain.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.domain.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.domain.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"A group of text filter conditions. Use `condition` to control how multiple items combine:\nAND (default) = all must match, OR = any can match. Each item uses operators like 'is', 'contains', etc.","uniqueKey":"filters.domain","typeLabel":"StringFilterGroup · object"},"url":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.url.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.url.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.url.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.url.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.url.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"A group of text filter conditions. Use `condition` to control how multiple items combine:\nAND (default) = all must match, OR = any can match. Each item uses operators like 'is', 'contains', etc.","uniqueKey":"filters.url","typeLabel":"StringFilterGroup · object"},"path":{"properties":{"condition":{"type":"string","enum":["AND","OR"],"title":"FilterConditionType","description":"'AND' (all conditions must match, default) or 'OR' (any condition can match).","x-enumDescriptions":{"AND":"All conditions must match (intersection)","OR":"Any condition can match (union)"},"default":"AND","examples":["OR"],"uniqueKey":"filters.path.condition","typeLabel":"enum\u003cstring>"},"items":{"items":{"properties":{"operator":{"type":"string","enum":["is","is_not","contains","not_contains"],"title":"StringOperator","description":"'is' (exact match), 'is_not' (exclude), 'contains' (partial, case-insensitive), 'not_contains' (exclude partial)","x-enumDescriptions":{"contains":"Partial text match (case-insensitive). Value is matched using ILIKE","is":"Exact match. If value is a UUID, matches by ID; otherwise matches by name/text","is_not":"Exclude exact match. Inverse of 'is'","not_contains":"Exclude partial text match. Inverse of 'contains'"},"examples":["is","contains"],"isRequired":true,"uniqueKey":"filters.path.\\items.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"value":{"title":"Value","description":"An entity ID for exact matching, or text for name/content matching. Partial matching with 'contains' is case-insensitive.","examples":["550e8400-e29b-41d4-a716-446655440000","AI Tools"],"uniqueKey":"filters.path.\\items.items.[INDEX].value","typeLabel":"any"}},"additionalProperties":false,"type":"object","required":["operator"],"title":"StringFilterCondition","description":"A single text filter condition.\n\nOperators:\n- `is` — Exact match by ID or name.\n- `is_not` — Exclude exact match.\n- `contains` — Partial text match (case-insensitive).\n- `not_contains` — Exclude partial text match.\n\nExample: {\"operator\": \"is\", \"value\": \"\u003ctopic-id>\"}\nExample: {\"operator\": \"contains\", \"value\": \"AI Tools\"}","uniqueKey":"filters.path.\\items.items.[INDEX]","typeLabel":"StringFilterCondition · object"},"type":"array","title":"Items","description":"List of filter conditions to apply.","examples":[[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]],"uniqueKey":"filters.path.\\items","typeLabel":"StringFilterCondition · object[]"}},"additionalProperties":false,"type":"object","title":"StringFilterGroup","description":"A group of text filter conditions. Use `condition` to control how multiple items combine:\nAND (default) = all must match, OR = any can match. Each item uses operators like 'is', 'contains', etc.","uniqueKey":"filters.path","typeLabel":"StringFilterGroup · object"}},"additionalProperties":false,"type":"object","title":"CitationFiltersInput","description":"Optional filters to narrow down citations by domain, URL, or path.","uniqueKey":"filters","typeLabel":"CitationFiltersInput · object"}},"additionalProperties":false,"type":"object","required":["project_id"],"title":"GetAllCitationsRequest","description":"Request parameters for retrieving all citations.","uniqueKey":"","typeLabel":"GetAllCitationsRequest · object"},"examples":{"Example":{"title":"Example","value":{"project_id":"550e8400-e29b-41d4-a716-446655440000","start_date":"2026-01-01T00:00:00Z","end_date":"2026-01-31T23:59:59Z","current_from":"2023-11-07T05:31:56Z","current_to":"2023-11-07T05:31:56Z","comparison_start_date":"2026-07-25T00:00:00Z","comparison_end_date":"2026-07-31T23:59:59Z","previous_from":"2023-11-07T05:31:56Z","previous_to":"2023-11-07T05:31:56Z","order_by":[{"field":"visibility_score","order":"desc"}],"pagination":{"limit":10,"offset":0},"metrics":["citation_share","citing_answers","source_type"],"filters":{"topics":{"condition":"OR","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]},"prompts":{"condition":"AND","items":[{"operator":"contains","value":"best AI tools"}]},"tags":{"condition":"OR","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"}]},"markets":{"condition":"OR","items":[{"operator":"is","value":"United States"},{"operator":"is","value":"United Kingdom"}]},"intent":{"condition":"OR","items":[{"operator":"is","value":"informational"},{"operator":"is","value":"commercial"}]},"branded":{"condition":"AND","items":[{"operator":"is","value":false}]},"platform":{"condition":"OR","items":[{"operator":"is","value":"ChatGPT"},{"operator":"is","value":"Perplexity"}]},"has_shopping_card":{"condition":"AND","items":[{"operator":"is","value":true}]},"has_ads_data":{"condition":"AND","items":[{"operator":"is","value":true}]},"visibility":{"condition":"AND","items":[{"operator":"gte","value":50}]},"rank":{"condition":"AND","items":[{"operator":"lte","value":3}]},"volume":{"condition":"AND","items":[{"operator":"gte","value":1000}]},"website_mentioned_in_answer":{"condition":"AND","items":[{"operator":"contains","value":"writesonic.com"}]},"cited_page_url":{"condition":"AND","items":[{"operator":"contains","value":"/blog/"}]},"cited_domain":{"condition":"AND","items":[{"operator":"is","value":"writesonic.com"}]},"website_mentioned_in_citation":{"condition":"AND","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"}]},"advanced_filters":{"conditions":[{"field":"topics","operator":"is","value":"\u003ctopic-id>"},{"field":"platform","operator":"is","value":"Grok"}],"join":"or"},"domain":{"condition":"OR","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]},"url":{"condition":"OR","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]},"path":{"condition":"OR","items":[{"operator":"is","value":"550e8400-e29b-41d4-a716-446655440000"},{"operator":"contains","value":"SEO"}]}}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"2cfd6b2c-c7e0-47c0-9d2d-075c3f9635c5":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"data":{"items":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier of the citation","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"url":{"type":"string","title":"Url","description":"Full URL of the cited page","isRequired":true,"uniqueKey":"data.items.[INDEX].url","typeLabel":"string"},"domain":{"type":"string","title":"Domain","description":"Domain name of the citation source","isRequired":true,"uniqueKey":"data.items.[INDEX].domain","typeLabel":"string"},"title":{"type":"string","title":"Title","description":"Page title of the cited source","uniqueKey":"data.items.[INDEX].title","typeLabel":"string"},"path":{"type":"string","title":"Path","description":"URL path of the cited page","uniqueKey":"data.items.[INDEX].path","typeLabel":"string"},"websites":{"items":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier of the website","isRequired":true,"uniqueKey":"data.items.[INDEX].websites.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","title":"Name","description":"Display name of the website","isRequired":true,"uniqueKey":"data.items.[INDEX].websites.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","title":"Url","description":"Website URL","uniqueKey":"data.items.[INDEX].websites.items.[INDEX].url","typeLabel":"string"},"is_self":{"type":"boolean","title":"Is Self","description":"True if this is your brand's website, False for competitors","default":false,"uniqueKey":"data.items.[INDEX].websites.items.[INDEX].is_self","typeLabel":"boolean"}},"type":"object","required":["id","name"],"title":"WebsiteItem","description":"A website associated with a citation.","uniqueKey":"data.items.[INDEX].websites.items.[INDEX]","typeLabel":"WebsiteItem · object"},"type":"array","title":"Websites","description":"Websites mentioned alongside this citation","uniqueKey":"data.items.[INDEX].websites","typeLabel":"WebsiteItem · object[]"},"created_date":{"type":"string","format":"date","title":"Created Date","description":"Date when the citation was first discovered","uniqueKey":"data.items.[INDEX].created_date","typeLabel":"string\u003cdate>"},"citation_share":{"type":"number","title":"Citation Share","description":"% of answers in range that cite this page","uniqueKey":"data.items.[INDEX].citation_share","typeLabel":"number"},"citing_answers":{"type":"integer","title":"Citing Answers","description":"Answers in range that cite this page","uniqueKey":"data.items.[INDEX].citing_answers","typeLabel":"integer"},"citing_answers_mentioning_you":{"type":"integer","title":"Citing Answers Mentioning You","description":"Citing answers that also mention your brand","uniqueKey":"data.items.[INDEX].citing_answers_mentioning_you","typeLabel":"integer"},"visibility_contribution":{"type":"number","title":"Visibility Contribution","description":"% of your brand mentions that came from answers citing this page","uniqueKey":"data.items.[INDEX].visibility_contribution","typeLabel":"number"},"source_type":{"type":"string","title":"Source Type","description":"owned | competitor | social_forums | third_party","uniqueKey":"data.items.[INDEX].source_type","typeLabel":"string"},"platforms":{"items":{"properties":{"platform":{"type":"string","title":"Platform","description":"Provider name, e.g. ChatGPT","isRequired":true,"uniqueKey":"data.items.[INDEX].platforms.items.[INDEX].platform","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"Model name","isRequired":true,"uniqueKey":"data.items.[INDEX].platforms.items.[INDEX].name","typeLabel":"string"},"logo":{"type":"string","title":"Logo","description":"Model icon URL","uniqueKey":"data.items.[INDEX].platforms.items.[INDEX].logo","typeLabel":"string"}},"type":"object","required":["platform","name"],"title":"PlatformRef","uniqueKey":"data.items.[INDEX].platforms.items.[INDEX]","typeLabel":"PlatformRef · object"},"type":"array","title":"Platforms","description":"AI platforms whose answers cited this page","uniqueKey":"data.items.[INDEX].platforms","typeLabel":"PlatformRef · object[]"},"topics":{"items":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Topic ID","isRequired":true,"uniqueKey":"data.items.[INDEX].topics.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"topic":{"type":"string","title":"Topic","description":"Topic name","isRequired":true,"uniqueKey":"data.items.[INDEX].topics.items.[INDEX].topic","typeLabel":"string"}},"type":"object","required":["id","topic"],"title":"TopicRef","uniqueKey":"data.items.[INDEX].topics.items.[INDEX]","typeLabel":"TopicRef · object"},"type":"array","title":"Topics","description":"Topics of the prompts whose answers cited this page","uniqueKey":"data.items.[INDEX].topics","typeLabel":"TopicRef · object[]"},"content_last_cited":{"type":"string","format":"date-time","title":"Content Last Cited","description":"Most recent time an answer cited this page","uniqueKey":"data.items.[INDEX].content_last_cited","typeLabel":"string\u003cdate-time>"},"previous_citation_share":{"type":"number","title":"Previous Citation Share","description":"citation_share over the comparison range","uniqueKey":"data.items.[INDEX].previous_citation_share","typeLabel":"number"},"previous_citing_answers":{"type":"integer","title":"Previous Citing Answers","description":"citing_answers over the comparison range","uniqueKey":"data.items.[INDEX].previous_citing_answers","typeLabel":"integer"},"previous_citing_answers_mentioning_you":{"type":"integer","title":"Previous Citing Answers Mentioning You","description":"citing_answers_mentioning_you over the comparison range","uniqueKey":"data.items.[INDEX].previous_citing_answers_mentioning_you","typeLabel":"integer"},"previous_visibility_contribution":{"type":"number","title":"Previous Visibility Contribution","description":"visibility_contribution over the comparison range","uniqueKey":"data.items.[INDEX].previous_visibility_contribution","typeLabel":"number"}},"type":"object","required":["id","url","domain"],"title":"CitationDataItem","description":"Data for a single citation.","uniqueKey":"data.items.[INDEX]","typeLabel":"CitationDataItem · object"},"type":"array","title":"Data","description":"Array of citation data items","isRequired":true,"uniqueKey":"data","typeLabel":"CitationDataItem · object[]"},"info":{"properties":{"total_rows":{"type":"integer","title":"Total Rows","description":"Total number of rows matching the query (before pagination)","isRequired":true,"uniqueKey":"info.total_rows","typeLabel":"integer"},"query":{"properties":{"metrics":{"items":{"type":"string","uniqueKey":"info.query.metrics.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Metrics","description":"Metrics that were requested","isRequired":true,"uniqueKey":"info.query.metrics","typeLabel":"string[]"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date used in the query","isRequired":true,"uniqueKey":"info.query.start_date","typeLabel":"string\u003cdate-time>"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date used in the query","isRequired":true,"uniqueKey":"info.query.end_date","typeLabel":"string\u003cdate-time>"},"order_by":{"additionalProperties":{"type":"string","uniqueKey":"info.query.order_by.additionalProperties","typeLabel":"string"},"type":"object","title":"Order By","description":"Sorting applied to the results","isRequired":true,"uniqueKey":"info.query.order_by","typeLabel":"Order By · object"},"pagination":{"additionalProperties":{"type":"integer","uniqueKey":"info.query.pagination.additionalProperties","typeLabel":"integer"},"type":"object","title":"Pagination","description":"Pagination parameters used","isRequired":true,"uniqueKey":"info.query.pagination","typeLabel":"Pagination · object"},"filters":{"additionalProperties":false,"type":"object","title":"Filters","description":"Filters that were applied","isRequired":true,"uniqueKey":"info.query.filters","typeLabel":"Filters · object"},"comparison_start_date":{"type":"string","format":"date-time","title":"Comparison Start Date","description":"Start date of the comparison range, if requested","uniqueKey":"info.query.comparison_start_date","typeLabel":"string\u003cdate-time>"},"comparison_end_date":{"type":"string","format":"date-time","title":"Comparison End Date","description":"End date of the comparison range, if requested","uniqueKey":"info.query.comparison_end_date","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["metrics","start_date","end_date","order_by","pagination","filters"],"title":"QueryInfo","description":"Details of the query that produced this response","isRequired":true,"uniqueKey":"info.query","typeLabel":"QueryInfo · object"}},"type":"object","required":["total_rows","query"],"title":"ResponseInfo","description":"Information of the API request including total count and query details","uniqueKey":"info","typeLabel":"ResponseInfo · object"}},"type":"object","required":["data"],"title":"GetAllCitationsResponse","description":"Response containing citation data.","uniqueKey":"","typeLabel":"GetAllCitationsResponse · object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","url":"\u003cstring>","domain":"\u003cstring>","title":"\u003cstring>","path":"\u003cstring>","websites":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","url":"\u003cstring>","is_self":false}],"created_date":"2023-12-25","citation_share":123,"citing_answers":123,"citing_answers_mentioning_you":123,"visibility_contribution":123,"source_type":"\u003cstring>","platforms":[{"platform":"\u003cstring>","name":"\u003cstring>","logo":"\u003cstring>"}],"topics":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","topic":"\u003cstring>"}],"content_last_cited":"2023-11-07T05:31:56Z","previous_citation_share":123,"previous_citing_answers":123,"previous_citing_answers_mentioning_you":123,"previous_visibility_contribution":123}],"info":{"total_rows":123,"query":{"metrics":["\u003cstring>"],"start_date":"2023-11-07T05:31:56Z","end_date":"2023-11-07T05:31:56Z","order_by":{},"pagination":{},"filters":{},"comparison_start_date":"2023-11-07T05:31:56Z","comparison_end_date":"2023-11-07T05:31:56Z"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"1bcff58e-6e54-46fc-a26f-eb834fc9891b":{"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":{"9d8eda2e-997a-44ad-af32-9f75bbb06065":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"APIKeyHeader"}}},"servers":{"e2516a54-c064-424d-91ff-7b7645d759f6":{"url":"https://api.writesonic.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-KEY"}],"title":"APIKeyHeader"}]},"originalFileLocation":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU"},"subdomain":"writesonic","siteName":"Writesonic Docs","title":"Get All Citations - Writesonic Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T05:22:47.943Z","originalFileLocation":"api-reference/generic/get-all-citations.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=\"List individual citation records (URL, domain, title) found in AI responses. Example: \u0026quot;Show all citations from wikipedia.org.\u0026quot; Unlike /reports/citations which returns aggregated counts, this returns raw citation rows. Metrics (optional): citation_share, citing_answers, citing_answers_mentioning_you, visibility_contribution, source_type, platforms, topics, content_last_cited. Omit for the plain listing. Any metric switches to the dashboard\u0026#x27;s All Citations engine, so values match the app exactly; with comparison_start_date / comparison_end_date the numeric metrics also carry previous_. Filters: topics, prompts, tags, markets, intent, branded, platform, has_shopping_card, visibility, rank, website_mentioned_in_answer, cited_page_url, cited_domain, website_mentioned_in_citation, domain, url, path. With metrics: path, rank, visibility, has_shopping_card and tree-style advanced_filters are not supported (400), because the All Citations engine does not evaluate them; platform values naming a model widen to that model\u0026#x27;s provider. Sort fields: domain, url, title for the listing; with metrics, any numeric metric or content_last_cited. Dates: Defaults to all-time when no dates provided. Filter values: markets takes a market id or contains with a region code such as us (names like United States and labels like us - en match nothing); tags, topics and platform match by name or id. Pagination: Use pagination (limit 1-100, default 10; offset for paging). Use order_by for sorting. Response: Returns data array with info metadata containing total_rows (before pagination) and query (applied metrics, dates, sorting, pagination, filters).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Writesonic Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_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=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get All Citations - Writesonic Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"List individual citation records (URL, domain, title) found in AI responses. Example: \u0026quot;Show all citations from wikipedia.org.\u0026quot; Unlike /reports/citations which returns aggregated counts, this returns raw citation rows. Metrics (optional): citation_share, citing_answers, citing_answers_mentioning_you, visibility_contribution, source_type, platforms, topics, content_last_cited. Omit for the plain listing. Any metric switches to the dashboard\u0026#x27;s All Citations engine, so values match the app exactly; with comparison_start_date / comparison_end_date the numeric metrics also carry previous_. Filters: topics, prompts, tags, markets, intent, branded, platform, has_shopping_card, visibility, rank, website_mentioned_in_answer, cited_page_url, cited_domain, website_mentioned_in_citation, domain, url, path. With metrics: path, rank, visibility, has_shopping_card and tree-style advanced_filters are not supported (400), because the All Citations engine does not evaluate them; platform values naming a model widen to that model\u0026#x27;s provider. Sort fields: domain, url, title for the listing; with metrics, any numeric metric or content_last_cited. Dates: Defaults to all-time when no dates provided. Filter values: markets takes a market id or contains with a region code such as us (names like United States and labels like us - en match nothing); tags, topics and platform match by name or id. Pagination: Use pagination (limit 1-100, default 10; offset for paging). Use order_by for sorting. Response: Returns data array with info metadata containing total_rows (before pagination) and query (applied metrics, dates, sorting, pagination, filters).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Writesonic Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://writesonic.mintlify.site/_mintlify/api/og/v2?division=Generic\u0026amp;title=Get+All+Citations\u0026amp;description=List+individual+citation+records+%28URL%2C+domain%2C+title%29+found+in+AI+responses.%0A%0A**Example%3A**+%22Show+all+citations+from+wikipedia.org.%22+Unlike+%60%2Freports%2Fcitations%60+\u0026amp;theme=a19733924f789986a692f3c4\u0026amp;signature=6a6c7755dcb8f0a85c21c8f84432cd3a01fc23bbcae497d2610df5cfc50c8488\">\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=\"Get All Citations - Writesonic Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List individual citation records (URL, domain, title) found in AI responses. Example: \u0026quot;Show all citations from wikipedia.org.\u0026quot; Unlike /reports/citations which returns aggregated counts, this returns raw citation rows. Metrics (optional): citation_share, citing_answers, citing_answers_mentioning_you, visibility_contribution, source_type, platforms, topics, content_last_cited. Omit for the plain listing. Any metric switches to the dashboard\u0026#x27;s All Citations engine, so values match the app exactly; with comparison_start_date / comparison_end_date the numeric metrics also carry previous_. Filters: topics, prompts, tags, markets, intent, branded, platform, has_shopping_card, visibility, rank, website_mentioned_in_answer, cited_page_url, cited_domain, website_mentioned_in_citation, domain, url, path. With metrics: path, rank, visibility, has_shopping_card and tree-style advanced_filters are not supported (400), because the All Citations engine does not evaluate them; platform values naming a model widen to that model\u0026#x27;s provider. Sort fields: domain, url, title for the listing; with metrics, any numeric metric or content_last_cited. Dates: Defaults to all-time when no dates provided. Filter values: markets takes a market id or contains with a region code such as us (names like United States and labels like us - en match nothing); tags, topics and platform match by name or id. Pagination: Use pagination (limit 1-100, default 10; offset for paging). Use order_by for sorting. Response: Returns data array with info metadata containing total_rows (before pagination) and query (applied metrics, dates, sorting, pagination, filters).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://writesonic.mintlify.site/_mintlify/api/og/v2?division=Generic\u0026amp;title=Get+All+Citations\u0026amp;description=List+individual+citation+records+%28URL%2C+domain%2C+title%29+found+in+AI+responses.%0A%0A**Example%3A**+%22Show+all+citations+from+wikipedia.org.%22+Unlike+%60%2Freports%2Fcitations%60+\u0026amp;theme=a19733924f789986a692f3c4\u0026amp;signature=6a6c7755dcb8f0a85c21c8f84432cd3a01fc23bbcae497d2610df5cfc50c8488\">\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=\"/mintlify-assets/_mintlify/favicons/writesonic/MlW01xdJYx4ttlxz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Writesonic Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF6719\">\u003clink data-mint-head rel=\"canonical\" href=\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/generic/get-all-citations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://apidocs.writesonic.com/#organization\",\"name\":\"Writesonic Docs\",\"url\":\"https://apidocs.writesonic.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/writesonic/pJXgH59hJ3fQBw5s/images/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=pJXgH59hJ3fQBw5s\u0026q=85\u0026s=12c1c23ddbb7e4ef1e6a1243503b4114\"}},{\"@type\":\"WebSite\",\"@id\":\"https://apidocs.writesonic.com#website\",\"name\":\"Writesonic Docs\",\"url\":\"https://apidocs.writesonic.com\",\"publisher\":{\"@id\":\"https://apidocs.writesonic.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations#webpage\",\"url\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations\",\"name\":\"Get All Citations\",\"description\":\"List individual citation records (URL, domain, title) found in AI responses. Example: \\\"Show all citations from wikipedia.org.\\\" Unlike /reports/citations which returns aggregated counts, this returns raw citation rows. Metrics (optional): citation_share, citing_answers, citing_answers_mentioning_you, visibility_contribution, source_type, platforms, topics, content_last_cited. Omit for the plain listing. Any metric switches to the dashboard's All Citations engine, so values match the app exactly; with comparison_start_date / comparison_end_date the numeric metrics also carry previous_. Filters: topics, prompts, tags, markets, intent, branded, platform, has_shopping_card, visibility, rank, website_mentioned_in_answer, cited_page_url, cited_domain, website_mentioned_in_citation, domain, url, path. With metrics: path, rank, visibility, has_shopping_card and tree-style advanced_filters are not supported (400), because the All Citations engine does not evaluate them; platform values naming a model widen to that model's provider. Sort fields: domain, url, title for the listing; with metrics, any numeric metric or content_last_cited. Dates: Defaults to all-time when no dates provided. Filter values: markets takes a market id or contains with a region code such as us (names like United States and labels like us - en match nothing); tags, topics and platform match by name or id. Pagination: Use pagination (limit 1-100, default 10; offset for paging). Use order_by for sorting. Response: Returns data array with info metadata containing total_rows (before pagination) and query (applied metrics, dates, sorting, pagination, filters).\",\"dateModified\":\"2026-11-05T05:22:47.943Z\",\"isPartOf\":{\"@id\":\"https://apidocs.writesonic.com#website\"},\"breadcrumb\":{\"@id\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Generic\",\"item\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-projects\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get All Citations\",\"item\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations#apireference\",\"headline\":\"Get All Citations\",\"name\":\"Get All Citations\",\"description\":\"List individual citation records (URL, domain, title) found in AI responses. Example: \\\"Show all citations from wikipedia.org.\\\" Unlike /reports/citations which returns aggregated counts, this returns raw citation rows. Metrics (optional): citation_share, citing_answers, citing_answers_mentioning_you, visibility_contribution, source_type, platforms, topics, content_last_cited. Omit for the plain listing. Any metric switches to the dashboard's All Citations engine, so values match the app exactly; with comparison_start_date / comparison_end_date the numeric metrics also carry previous_. Filters: topics, prompts, tags, markets, intent, branded, platform, has_shopping_card, visibility, rank, website_mentioned_in_answer, cited_page_url, cited_domain, website_mentioned_in_citation, domain, url, path. With metrics: path, rank, visibility, has_shopping_card and tree-style advanced_filters are not supported (400), because the All Citations engine does not evaluate them; platform values naming a model widen to that model's provider. Sort fields: domain, url, title for the listing; with metrics, any numeric metric or content_last_cited. Dates: Defaults to all-time when no dates provided. Filter values: markets takes a market id or contains with a region code such as us (names like United States and labels like us - en match nothing); tags, topics and platform match by name or id. Pagination: Use pagination (limit 1-100, default 10; offset for paging). Use order_by for sorting. Response: Returns data array with info metadata containing total_rows (before pagination) and query (applied metrics, dates, sorting, pagination, filters).\",\"url\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations\",\"mainEntityOfPage\":{\"@id\":\"https://apidocs.writesonic.com/api-reference/generic/get-all-citations#webpage\"},\"dateModified\":\"2026-11-05T05:22:47.943Z\",\"publisher\":{\"@id\":\"https://apidocs.writesonic.com/#organization\"},\"isPartOf\":{\"@id\":\"https://apidocs.writesonic.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Writesonic Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Writesonic Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/generic/get-all-citations.md","siteName":"Writesonic Docs","nav":{"global":{"anchors":[{"anchor":"Open Writesonic","icon":"arrow-up-right-from-square","href":"https://app.writesonic.com/?utm_source=docs"},{"anchor":"Book a demo","icon":"headset","href":"https://writesonic.com/?demo=open"}]},"tabs":[{"tab":"Platform","icon":"book-open","pages":[{"title":"Platform","href":"/docs/geo-getting-started"}]},{"tab":"Agents","icon":"sparkles","pages":[{"title":"Agents","href":"/agents/overview"}]},{"tab":"Writesonic REST API","icon":"square-terminal","groups":[{"group":"Getting Started","pages":[{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Generic","pages":[{"title":"Get All Projects","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/projects","href":"/api-reference/generic/get-all-projects"},{"title":"Get All Prompts","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/prompts","href":"/api-reference/generic/get-all-prompts"},{"title":"Get All Topics","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/topics","href":"/api-reference/generic/get-all-topics"},{"title":"Get Tags","description":"List all tags (custom labels attached to prompts).\n\n**Example:** \"Show tags with their query counts and associated competitors.\"\n\n**Metrics** (optional): `query_count`, `competitor_count`, `queries`, `competitors`\n\n**Filters:** `topics`, `prompts`, `tags`, `markets`, `intent`, `branded`, `platform`, `has_shopping_card`, `visibility`, `rank`, `website_mentioned_in_answer`, `cited_page_url`, `cited_domain`, `website_mentioned_in_citation`, `slug`, `competitors`.\n\n**Sort fields:** Any metric name, plus `name`.\n\n**Dates:** If metrics are requested without dates, defaults to latest run date range. If no metrics and no dates, defaults to all-time.\n\n**Filter values:** `markets` takes a market id or `contains` with a region code such as `us` (names like `United States` and labels like `us - en` match nothing); `tags`, `topics` and `platform` match by name or id.\n\n**Pagination:** Use `pagination` (`limit` 1-100, default 10; `offset` for paging). Use `order_by` for sorting.\n\n**Response:** Returns `data` array with `info` metadata containing `total_rows` (before pagination) and `query` (applied metrics, dates, sorting, pagination, filters).","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/tags","href":"/api-reference/generic/get-tags"},{"title":"Get All Citations","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/citations","href":"/api-reference/generic/get-all-citations"},{"title":"Get Websites","description":"Compare your brand against competitors with per-website performance metrics. `share_of_voice` is not an accepted metric here; for share of voice use `/reports/performance`. Lists every domain seen in AI answers (`total_rows` can be tens of thousands); To rank competitors by visibility or share of voice use `/reports/performance` with dimension `website`.\n\n**Example:** \"Benchmark visibility and citation share across all tracked websites.\"\n\n**Metrics** (optional): `mentions_count`, `citation_share`, `cited_answers`, `visibility_score`, `rank`\n\n`citation_share` is the percentage of answers in the period citing one of the website's domains (0-100), the same definition as `/reports/performance`.\n\n**Filters:** `topics`, `prompts`, `tags`, `markets`, `intent`, `branded`, `platform`, `has_shopping_card`, `visibility`, `rank`, `website_mentioned_in_answer`, `cited_page_url`, `cited_domain`, `website_mentioned_in_citation`, `url`, `name`.\n\n**Sort fields:** `citation_share`, `created_date`, `mentions_count`, `name`, `rank`, `url`, `visibility_score` (`cited_answers` is a metric but cannot be sorted).\n\n**Dates:** If metrics are requested without dates, defaults to latest run date range. If no metrics and no dates, defaults to all-time.\n\n**Filter values:** `markets` takes a market id or `contains` with a region code such as `us` (names like `United States` and labels like `us - en` match nothing); `tags`, `topics` and `platform` match by name or id.\n\n**Pagination:** Use `pagination` (`limit` 1-100, default 10; `offset` for paging). Use `order_by` for sorting.\n\n**Response:** Returns `data` array with `info` metadata containing `total_rows` (before pagination) and `query` (applied metrics, dates, sorting, pagination, filters).","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/websites","href":"/api-reference/generic/get-websites"},{"title":"Get Keywords","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/keywords","href":"/api-reference/generic/get-keywords"},{"title":"Get AI Models","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/models","href":"/api-reference/generic/get-ai-models"},{"title":"Get Markets","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/markets","href":"/api-reference/generic/get-markets"},{"title":"Get Domain Reports","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/business/domains","href":"/api-reference/generic/get-domain-reports"}]},{"group":"Reports","pages":[{"title":"Get Performance Report","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/reports/performance","href":"/api-reference/reports/get-performance-report"},{"title":"Get Citation Report","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/reports/citations","href":"/api-reference/reports/get-citation-report"},{"title":"Get Sentiment Report","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/reports/sentiments","href":"/api-reference/reports/get-sentiment-report"},{"title":"Get Ads Report","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/reports/ads","href":"/api-reference/reports/get-ads-report"},{"title":"Get Shopping Report","deprecated":null,"version":null,"openapi":"https://api.writesonic.com/v1/oauth/openapi.json?client_secret=FgwCVph3cjZy0KPsvsuU post /v2/geo/reports/shopping","href":"/api-reference/reports/get-shopping-report"}]}]},{"tab":"Writesonic MCP Server","icon":"plug","pages":[{"title":"Writesonic MCP Server","href":"/mcp/mcp-server"}]},{"tab":"Agents REST API","icon":"code","pages":[{"title":"Agents REST API","href":"/api-reference/agents/authentication"}]},{"tab":"Agents MCP Server","icon":"plug","pages":[{"title":"Agents MCP Server","href":"/agents-mcp/mcp-server"}]}]},"basePath":"","title":"Get All Citations - Writesonic Docs","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}