The report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a prompt_id filter to narrow it.
Aggregation Formulas
When aggregating results across multiple rows/dimensions, use the following formula:
filters are pre-aggregation row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap, url_tag_id, domain_tag_id.
Population (model_id, model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id) shrink both numerator and denominator scope.
Source-side (domain, domain_classification, url, url_classification) and per-row mentioned-brand predicates (mentioned_brand_id, mentioned_brand_count, gap) shrink the source-row scope feeding aggregation.
having are post-aggregation row filters (applied as HAVING after GROUP BY). Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap.
citation_rate is computed per row from numerator (citation_count) and denominator (retrieval_count) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both filters and having — use filters to prune source rows before aggregation (typically more efficient), use having to operate on the aggregated mentioned_brands union for entity-wide selection.
Pre-aggregation row filters (applied as WHERE before grouping). Restrict which raw source-rows feed into the per-URL aggregation. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap, url_tag_id, domain_tag_id. Multiple filters are AND'd.
Post-aggregation row filters (applied as HAVING after grouping). Select which aggregated URL rows are returned. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap — population fields require the matching value in dimensions. Multiple filters are AND'd.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Peec.ai Docs","colors":{"primary":"#000000","light":"#ffffff","dark":"#000000"},"logo":{"light":"https://mintcdn.com/peecai-b61a1960/BVQQX1wLWNjFOa_V/images/logo-white.svg?fit=max\u0026auto=format\u0026n=BVQQX1wLWNjFOa_V\u0026q=85\u0026s=5d3f30a498a2c71a875226adc1a9de52","dark":"https://mintcdn.com/peecai-b61a1960/AOqHu6-lYtIlVNI6/logo/PeecLogoWhite.png?fit=max\u0026auto=format\u0026n=AOqHu6-lYtIlVNI6\u0026q=85\u0026s=e68e57c3a6bd47ff8081386db20cc746"},"favicon":"https://mintcdn.com/peecai-b61a1960/ZPzAGzjR7kY6FmUI/favicon.ico?fit=max\u0026auto=format\u0026n=ZPzAGzjR7kY6FmUI\u0026q=85\u0026s=d8aae543639fa5a02a8634eedd5cfb2f","navbar":{"links":[{"href":"mailto:support@peec.ai","label":"Contact"},{"href":"https://peec.ai","label":"Website"},{"href":"https://app.peec.ai/sign-in","label":"Log In"}]},"footer":{"socials":{"website":"https://peec.ai","linkedin":"https://www.linkedin.com/company/peec-ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"peecai-b61a1960","hasAudioNarration":false,"actualSubdomain":"peecai-b61a1960","customDomains":["docs.peec.ai"],"gitSource":{"type":"github","owner":"peec-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff31ac0b27e3d5820c3f1e","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Customer API","count":123},{"language":"default","tag":"Endpoints","count":117},{"language":"default","tag":"Project","count":62},{"language":"default","tag":"Research","count":52},{"language":"default","tag":"Documentation","count":44},{"language":"default","tag":"Brand Perception","count":17},{"language":"default","tag":"Products","count":17},{"language":"default","tag":"Interpret Your Results","count":9},{"language":"default","tag":"Agent Analytics","count":9},{"language":"default","tag":"Overview","count":8}]},"assistantConfig":{},"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/reports/get-urls-report","slug":"/api-reference/reports/get-urls-report","pageMetadata":{"title":"Get URLs Report","description":"Get a report on Source URLs.\n\n## Prompt Scope\n\nThe report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a `prompt_id` filter to narrow it.\n\n## Aggregation Formulas\n\nWhen aggregating results across multiple rows/dimensions, use the following formula:\n\n- **citation_rate**: `sum(citation_count) / sum(retrieval_count)`\n- **citation_position**: `sum(citation_position_sum) / sum(citation_position_count)`\n\n## `filters` vs `having`\n\n`filters` are **pre-aggregation** row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`, `url_tag_id`, `domain_tag_id`.\n- Population (`model_id`, `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`) shrink both numerator and denominator scope.\n- Source-side (`domain`, `domain_classification`, `url`, `url_classification`) and per-row mentioned-brand predicates (`mentioned_brand_id`, `mentioned_brand_count`, `gap`) shrink the source-row scope feeding aggregation.\n\n`having` are **post-aggregation** row filters (applied as HAVING after GROUP BY). Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`.\n\n`citation_rate` is computed per row from numerator (`citation_count`) and denominator (`retrieval_count`) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both `filters` and `having` — use `filters` to prune source rows before aggregation (typically more efficient), use `having` to operate on the aggregated `mentioned_brands` union for entity-wide selection.","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /reports/urls","href":"/api-reference/reports/get-urls-report","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 h2: \"h2\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Get a report on Source URLs.\"\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Prompt Scope\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a \", _jsx(_components.code, {\n children: \"prompt_id\"\n }), \" filter to narrow it.\"]\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Aggregation Formulas\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"When aggregating results across multiple rows/dimensions, use the following formula:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"citation_rate\"\n }), \": \", _jsx(_components.code, {\n children: \"sum(citation_count) / sum(retrieval_count)\"\n })]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"citation_position\"\n }), \": \", _jsx(_components.code, {\n children: \"sum(citation_position_sum) / sum(citation_position_count)\"\n })]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.h2, {\n children: [_jsx(_components.code, {\n children: \"filters\"\n }), \" vs \", _jsx(_components.code, {\n children: \"having\"\n })]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"filters\"\n }), \" are \", _jsx(_components.strong, {\n children: \"pre-aggregation\"\n }), \" row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: \", _jsx(_components.code, {\n children: \"model_id\"\n }), \" (deprecated), \", _jsx(_components.code, {\n children: \"model_channel_id\"\n }), \", \", _jsx(_components.code, {\n children: \"country_code\"\n }), \", \", _jsx(_components.code, {\n children: \"prompt_id\"\n }), \", \", _jsx(_components.code, {\n children: \"tag_id\"\n }), \", \", _jsx(_components.code, {\n children: \"topic_id\"\n }), \", \", _jsx(_components.code, {\n children: \"chat_id\"\n }), \", \", _jsx(_components.code, {\n children: \"domain\"\n }), \", \", _jsx(_components.code, {\n children: \"domain_classification\"\n }), \", \", _jsx(_components.code, {\n children: \"url\"\n }), \", \", _jsx(_components.code, {\n children: \"url_classification\"\n }), \", \", _jsx(_components.code, {\n children: \"mentioned_brand_id\"\n }), \", \", _jsx(_components.code, {\n children: \"mentioned_brand_count\"\n }), \", \", _jsx(_components.code, {\n children: \"gap\"\n }), \", \", _jsx(_components.code, {\n children: \"url_tag_id\"\n }), \", \", _jsx(_components.code, {\n children: \"domain_tag_id\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Population (\", _jsx(_components.code, {\n children: \"model_id\"\n }), \", \", _jsx(_components.code, {\n children: \"model_channel_id\"\n }), \", \", _jsx(_components.code, {\n children: \"country_code\"\n }), \", \", _jsx(_components.code, {\n children: \"prompt_id\"\n }), \", \", _jsx(_components.code, {\n children: \"tag_id\"\n }), \", \", _jsx(_components.code, {\n children: \"topic_id\"\n }), \", \", _jsx(_components.code, {\n children: \"chat_id\"\n }), \") shrink both numerator and denominator scope.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Source-side (\", _jsx(_components.code, {\n children: \"domain\"\n }), \", \", _jsx(_components.code, {\n children: \"domain_classification\"\n }), \", \", _jsx(_components.code, {\n children: \"url\"\n }), \", \", _jsx(_components.code, {\n children: \"url_classification\"\n }), \") and per-row mentioned-brand predicates (\", _jsx(_components.code, {\n children: \"mentioned_brand_id\"\n }), \", \", _jsx(_components.code, {\n children: \"mentioned_brand_count\"\n }), \", \", _jsx(_components.code, {\n children: \"gap\"\n }), \") shrink the source-row scope feeding aggregation.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"having\"\n }), \" are \", _jsx(_components.strong, {\n children: \"post-aggregation\"\n }), \" row filters (applied as HAVING after GROUP BY). Allowed fields: \", _jsx(_components.code, {\n children: \"model_id\"\n }), \" (deprecated), \", _jsx(_components.code, {\n children: \"model_channel_id\"\n }), \", \", _jsx(_components.code, {\n children: \"country_code\"\n }), \", \", _jsx(_components.code, {\n children: \"prompt_id\"\n }), \", \", _jsx(_components.code, {\n children: \"tag_id\"\n }), \", \", _jsx(_components.code, {\n children: \"topic_id\"\n }), \", \", _jsx(_components.code, {\n children: \"chat_id\"\n }), \", \", _jsx(_components.code, {\n children: \"domain\"\n }), \", \", _jsx(_components.code, {\n children: \"domain_classification\"\n }), \", \", _jsx(_components.code, {\n children: \"url\"\n }), \", \", _jsx(_components.code, {\n children: \"url_classification\"\n }), \", \", _jsx(_components.code, {\n children: \"mentioned_brand_id\"\n }), \", \", _jsx(_components.code, {\n children: \"mentioned_brand_count\"\n }), \", \", _jsx(_components.code, {\n children: \"gap\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"citation_rate\"\n }), \" is computed per row from numerator (\", _jsx(_components.code, {\n children: \"citation_count\"\n }), \") and denominator (\", _jsx(_components.code, {\n children: \"retrieval_count\"\n }), \") inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both \", _jsx(_components.code, {\n children: \"filters\"\n }), \" and \", _jsx(_components.code, {\n children: \"having\"\n }), \" — use \", _jsx(_components.code, {\n children: \"filters\"\n }), \" to prune source rows before aggregation (typically more efficient), use \", _jsx(_components.code, {\n children: \"having\"\n }), \" to operate on the aggregated \", _jsx(_components.code, {\n children: \"mentioned_brands\"\n }), \" union for entity-wide selection.\"]\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":{"config":{},"pageMetadata":{"title":"Get URLs Report","description":"Get a report on Source URLs.\n\n## Prompt Scope\n\nThe report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a `prompt_id` filter to narrow it.\n\n## Aggregation Formulas\n\nWhen aggregating results across multiple rows/dimensions, use the following formula:\n\n- **citation_rate**: `sum(citation_count) / sum(retrieval_count)`\n- **citation_position**: `sum(citation_position_sum) / sum(citation_position_count)`\n\n## `filters` vs `having`\n\n`filters` are **pre-aggregation** row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`, `url_tag_id`, `domain_tag_id`.\n- Population (`model_id`, `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`) shrink both numerator and denominator scope.\n- Source-side (`domain`, `domain_classification`, `url`, `url_classification`) and per-row mentioned-brand predicates (`mentioned_brand_id`, `mentioned_brand_count`, `gap`) shrink the source-row scope feeding aggregation.\n\n`having` are **post-aggregation** row filters (applied as HAVING after GROUP BY). Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`.\n\n`citation_rate` is computed per row from numerator (`citation_count`) and denominator (`retrieval_count`) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both `filters` and `having` — use `filters` to prune source rows before aggregation (typically more efficient), use `having` to operate on the aggregated `mentioned_brands` union for entity-wide selection.","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /reports/urls","href":"/api-reference/reports/get-urls-report","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"security":["13cc489c-19d4-424a-b542-1783a2bcbf4f","026ed8f8-2ebf-4195-b481-a450da9781de"],"summary":"Get URLs Report","description":"Get a report on Source URLs.\n\n## Prompt Scope\n\nThe report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a `prompt_id` filter to narrow it.\n\n## Aggregation Formulas\n\nWhen aggregating results across multiple rows/dimensions, use the following formula:\n\n- **citation_rate**: `sum(citation_count) / sum(retrieval_count)`\n- **citation_position**: `sum(citation_position_sum) / sum(citation_position_count)`\n\n## `filters` vs `having`\n\n`filters` are **pre-aggregation** row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`, `url_tag_id`, `domain_tag_id`.\n- Population (`model_id`, `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`) shrink both numerator and denominator scope.\n- Source-side (`domain`, `domain_classification`, `url`, `url_classification`) and per-row mentioned-brand predicates (`mentioned_brand_id`, `mentioned_brand_count`, `gap`) shrink the source-row scope feeding aggregation.\n\n`having` are **post-aggregation** row filters (applied as HAVING after GROUP BY). Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`.\n\n`citation_rate` is computed per row from numerator (`citation_count`) and denominator (`retrieval_count`) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both `filters` and `having` — use `filters` to prune source rows before aggregation (typically more efficient), use `having` to operate on the aggregated `mentioned_brands` union for entity-wide selection.","tags":["Reports"],"parameters":["bbf44ba1-f495-4f9b-b7ce-46f433a88513"],"requestBody":"c678b563-ee7a-4c54-b1c4-673811c67c18","responses":{"200":"9cb0f067-a33c-4a22-853f-e3ee5295e1b0"},"operationId":"postReportsUrls","method":"post","type":"path","servers":["93546c49-a765-450f-84ae-564c3fccb791"],"path":"/reports/urls","baseUrlOptions":["https://api.peec.ai/customer/v1"],"title":"Get URLs Report","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"bbf44ba1-f495-4f9b-b7ce-46f433a88513":{"name":"project_id","in":"query","required":false,"schema":{"description":"Required if using a company api key","example":"or_f45b94ba-5e35-4982-93ed-285e72ee14eb","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"description":"Required if using a company api key","example":"or_f45b94ba-5e35-4982-93ed-285e72ee14eb","type":"string","uniqueKey":"project_id","typeLabel":"string"},"limit":{"default":1000,"type":"integer","minimum":1,"maximum":10000,"uniqueKey":"limit","typeLabel":"integer"},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"offset","typeLabel":"integer"},"start_date":{"default":"2026-01-01","description":"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21","example":"2025-09-22","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"start_date","typeLabel":"string\u003cdate>"},"end_date":{"default":"2026-01-01","description":"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21","example":"2025-09-22","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"end_date","typeLabel":"string\u003cdate>"},"dimensions":{"example":["tag_id","model_id"],"description":"Dimensions to break down the report by.","type":"array","items":{"type":"string","enum":["prompt_id","model_id","model_channel_id","tag_id","topic_id","date","week","month","country_code","chat_id"],"uniqueKey":"dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"dimensions","typeLabel":"enum\u003cstring>[]"},"filters":{"description":"Pre-aggregation row filters (applied as WHERE before grouping). Restrict which raw source-rows feed into the per-URL aggregation. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`, `url_tag_id`, `domain_tag_id`. Multiple filters are AND'd.","example":[{"field":"model_id","operator":"in","values":["gpt-4o-search"]}],"type":"array","items":{"oneOf":[{"type":"object","description":"Deprecated: use model_channel_id filter instead","required":["field","operator","values"],"deprecated":true,"properties":{"field":{"type":"string","enum":["model_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["chatgpt-scraper","gpt-4o","gpt-4o-search","gpt-3.5-turbo","llama-sonar","perplexity-scraper","sonar","gemini-2.5-flash","gemini-3.1-flash-lite-search","gemini-scraper","google-ai-overview-scraper","google-ai-mode-scraper","llama-3.3-70b-instruct","deepseek-r1","deepseek-v4-pro","claude-3.5-haiku","claude-haiku-4.5","claude-sonnet-4","grok-scraper","microsoft-copilot-scraper","copilot-search-scraper","chatgpt-logged-in-scraper","grok-4","grok-4.3","grok-4.6","qwen-3-6-plus","qwen-3-7-plus","amazon-rufus-scraper","mistral-small-4","mistral-medium-3-5","muse-spark-1.2","muse-spark-1.3","muse-wonder-1.0","gemini-4-argon","naver-ai-briefing-scraper","claude-opus-5","claude-fable-5.1","gpt-6-astra","gpt-5.6-sol","gpt-5.6-terra","ernie-scraper","exa-answer","parallel"],"uniqueKey":"filters.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["model_channel_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["openai-0","openai-1","qwen-0","openai-2","perplexity-0","perplexity-1","google-0","google-1","google-2","google-3","google-4","google-5","anthropic-0","anthropic-1","anthropic-2","anthropic-3","deepseek-0","meta-0","meta-1","meta-2","xai-0","xai-1","microsoft-0","amazon-0","mistral-0","mistral-1","naver-0","openai-3","openai-4","openai-5","baidu-0","exa-0","parallel-0","microsoft-1","openai-6"],"uniqueKey":"filters.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.2.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["topic_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.3.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["prompt_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.4.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["country_code"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["AE","AL","AM","AR","AT","AU","BA","BE","BG","BH","BO","BR","BS","BY","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","EC","EE","EG","ES","FI","FR","GB","GE","GH","GR","GT","HK","HN","HR","HU","ID","IE","IL","IN","IQ","IS","IT","JO","JP","KR","KW","LB","LI","LT","LU","LV","MA","MD","ME","MK","MN","MT","MX","MY","NG","NI","NL","NO","NZ","OM","PK","PA","PE","PH","PL","PT","PY","PR","PS","QA","RO","RS","SA","SE","SG","SI","SK","SR","SV","TH","TN","TR","TW","UA","US","UY","VE","VN","ZA","AD","AF","AS","AZ","BB","BQ","CG","CI","CM","CW","DM","DZ","FO","GF","GP","JM","KG","KH","KI","KZ","LK","LR","LS","MW","NC","PG","TD","TF","UG","VU","ZW"],"uniqueKey":"filters.items.[INDEX].oneOf.5.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["chat_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.6.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.7.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_classification"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.8.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (CORPORATE, EDITORIAL, INSTITUTIONAL, OTHER, REFERENCE, UGC, COMPETITOR, OWN, RELATED) or a custom domain classification name.","example":["CORPORATE","EDITORIAL","INSTITUTIONAL","OTHER","REFERENCE","UGC","COMPETITOR","OWN","RELATED"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.9.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_classification"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.10.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or a custom URL classification name.","example":["HOMEPAGE","CATEGORY_PAGE","PRODUCT_PAGE","LISTICLE","COMPARISON","PROFILE","ALTERNATIVE","DISCUSSION","HOW_TO_GUIDE","ARTICLE","REVIEW","OTHER"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["mentioned_brand_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.11.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["mentioned_brand_count"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.value","typeLabel":"integer"}},"uniqueKey":"filters.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["gap"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.value","typeLabel":"integer"}},"uniqueKey":"filters.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.14.values.items.[INDEX]","typeLabel":"string"},"description":"Source tag ids. `in` keeps URLs carrying any of them, `has_all` keeps URLs carrying every one of them, `not_in` keeps URLs carrying none of them.","example":["stg_23abec5b-100a-4261-9ee7-1effe68f0149"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.15.values.items.[INDEX]","typeLabel":"string"},"description":"Source tag ids. `in` keeps sources on domains carrying any of them, `has_all` keeps sources on domains carrying every one of them, `not_in` keeps sources on domains carrying none of them.","example":["stg_23abec5b-100a-4261-9ee7-1effe68f0149"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.15","typeLabel":"object"}],"uniqueKey":"filters.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters","typeLabel":"object[]"},"having":{"description":"Post-aggregation row filters (applied as HAVING after grouping). Select which aggregated URL rows are returned. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap` — population fields require the matching value in `dimensions`. Multiple filters are AND'd.","example":[{"field":"url","operator":"in","values":["https://example.com/page"]}],"type":"array","items":{"oneOf":[{"type":"object","description":"Deprecated: use model_channel_id filter instead","required":["field","operator","values"],"deprecated":true,"properties":{"field":{"type":"string","enum":["model_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["chatgpt-scraper","gpt-4o","gpt-4o-search","gpt-3.5-turbo","llama-sonar","perplexity-scraper","sonar","gemini-2.5-flash","gemini-3.1-flash-lite-search","gemini-scraper","google-ai-overview-scraper","google-ai-mode-scraper","llama-3.3-70b-instruct","deepseek-r1","deepseek-v4-pro","claude-3.5-haiku","claude-haiku-4.5","claude-sonnet-4","grok-scraper","microsoft-copilot-scraper","copilot-search-scraper","chatgpt-logged-in-scraper","grok-4","grok-4.3","grok-4.6","qwen-3-6-plus","qwen-3-7-plus","amazon-rufus-scraper","mistral-small-4","mistral-medium-3-5","muse-spark-1.2","muse-spark-1.3","muse-wonder-1.0","gemini-4-argon","naver-ai-briefing-scraper","claude-opus-5","claude-fable-5.1","gpt-6-astra","gpt-5.6-sol","gpt-5.6-terra","ernie-scraper","exa-answer","parallel"],"uniqueKey":"having.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["model_channel_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["openai-0","openai-1","qwen-0","openai-2","perplexity-0","perplexity-1","google-0","google-1","google-2","google-3","google-4","google-5","anthropic-0","anthropic-1","anthropic-2","anthropic-3","deepseek-0","meta-0","meta-1","meta-2","xai-0","xai-1","microsoft-0","amazon-0","mistral-0","mistral-1","naver-0","openai-3","openai-4","openai-5","baidu-0","exa-0","parallel-0","microsoft-1","openai-6"],"uniqueKey":"having.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["tag_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.2.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["topic_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.3.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["prompt_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.4.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["country_code"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["AE","AL","AM","AR","AT","AU","BA","BE","BG","BH","BO","BR","BS","BY","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","EC","EE","EG","ES","FI","FR","GB","GE","GH","GR","GT","HK","HN","HR","HU","ID","IE","IL","IN","IQ","IS","IT","JO","JP","KR","KW","LB","LI","LT","LU","LV","MA","MD","ME","MK","MN","MT","MX","MY","NG","NI","NL","NO","NZ","OM","PK","PA","PE","PH","PL","PT","PY","PR","PS","QA","RO","RS","SA","SE","SG","SI","SK","SR","SV","TH","TN","TR","TW","UA","US","UY","VE","VN","ZA","AD","AF","AS","AZ","BB","BQ","CG","CI","CM","CW","DM","DZ","FO","GF","GP","JM","KG","KH","KI","KZ","LK","LR","LS","MW","NC","PG","TD","TF","UG","VU","ZW"],"uniqueKey":"having.items.[INDEX].oneOf.5.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["chat_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.6.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.7.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_classification"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.8.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (CORPORATE, EDITORIAL, INSTITUTIONAL, OTHER, REFERENCE, UGC, COMPETITOR, OWN, RELATED) or a custom domain classification name.","example":["CORPORATE","EDITORIAL","INSTITUTIONAL","OTHER","REFERENCE","UGC","COMPETITOR","OWN","RELATED"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.9.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_classification"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.10.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or a custom URL classification name.","example":["HOMEPAGE","CATEGORY_PAGE","PRODUCT_PAGE","LISTICLE","COMPARISON","PROFILE","ALTERNATIVE","DISCUSSION","HOW_TO_GUIDE","ARTICLE","REVIEW","OTHER"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["mentioned_brand_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.11.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["mentioned_brand_count"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.value","typeLabel":"integer"}},"uniqueKey":"having.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["gap"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.value","typeLabel":"integer"}},"uniqueKey":"having.items.[INDEX].oneOf.13","typeLabel":"object"}],"uniqueKey":"having.items.[INDEX]","typeLabel":"object"},"uniqueKey":"having","typeLabel":"object[]"},"order_by":{"description":"Sort results by one or more fields. Multiple entries create a multi-key sort. Direction defaults to desc. When omitted, a default ordering is applied.","example":[{"field":"retrieval_count","direction":"desc"}],"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["retrieval_count","retrievals","citation_count","citation_rate","citation_position","gap_score","date","week","month"],"isRequired":true,"uniqueKey":"order_by.items.[INDEX].field","typeLabel":"enum\u003cstring>"},"direction":{"default":"desc","type":"string","enum":["asc","desc"],"uniqueKey":"order_by.items.[INDEX].direction","typeLabel":"enum\u003cstring>"}},"required":["field"],"uniqueKey":"order_by.items.[INDEX]","typeLabel":"object"},"uniqueKey":"order_by","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"project_id":"or_f45b94ba-5e35-4982-93ed-285e72ee14eb","limit":1000,"offset":0,"start_date":"2025-09-22","end_date":"2025-09-22","dimensions":["tag_id","model_id"],"filters":[{"field":"model_id","operator":"in","values":["gpt-4o-search"]}],"having":[{"field":"url","operator":"in","values":["https://example.com/page"]}],"order_by":[{"field":"retrieval_count","direction":"desc"}]}}},"exampleType":"generated"},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"project_id":{"description":"Required if using a company api key","example":"or_f45b94ba-5e35-4982-93ed-285e72ee14eb","type":"string","uniqueKey":"project_id","typeLabel":"string"},"limit":{"default":1000,"type":"integer","minimum":1,"maximum":10000,"uniqueKey":"limit","typeLabel":"integer"},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"offset","typeLabel":"integer"},"start_date":{"default":"2026-01-01","description":"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21","example":"2025-09-22","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"start_date","typeLabel":"string\u003cdate>"},"end_date":{"default":"2026-01-01","description":"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21","example":"2025-09-22","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"end_date","typeLabel":"string\u003cdate>"},"dimensions":{"example":["tag_id","model_id"],"description":"Dimensions to break down the report by.","type":"array","items":{"type":"string","enum":["prompt_id","model_id","model_channel_id","tag_id","topic_id","date","week","month","country_code","chat_id"],"uniqueKey":"dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"dimensions","typeLabel":"enum\u003cstring>[]"},"filters":{"description":"Pre-aggregation row filters (applied as WHERE before grouping). Restrict which raw source-rows feed into the per-URL aggregation. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`, `url_tag_id`, `domain_tag_id`. Multiple filters are AND'd.","example":[{"field":"model_id","operator":"in","values":["gpt-4o-search"]}],"type":"array","items":{"oneOf":[{"type":"object","description":"Deprecated: use model_channel_id filter instead","required":["field","operator","values"],"deprecated":true,"properties":{"field":{"type":"string","enum":["model_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["chatgpt-scraper","gpt-4o","gpt-4o-search","gpt-3.5-turbo","llama-sonar","perplexity-scraper","sonar","gemini-2.5-flash","gemini-3.1-flash-lite-search","gemini-scraper","google-ai-overview-scraper","google-ai-mode-scraper","llama-3.3-70b-instruct","deepseek-r1","deepseek-v4-pro","claude-3.5-haiku","claude-haiku-4.5","claude-sonnet-4","grok-scraper","microsoft-copilot-scraper","copilot-search-scraper","chatgpt-logged-in-scraper","grok-4","grok-4.3","grok-4.6","qwen-3-6-plus","qwen-3-7-plus","amazon-rufus-scraper","mistral-small-4","mistral-medium-3-5","muse-spark-1.2","muse-spark-1.3","muse-wonder-1.0","gemini-4-argon","naver-ai-briefing-scraper","claude-opus-5","claude-fable-5.1","gpt-6-astra","gpt-5.6-sol","gpt-5.6-terra","ernie-scraper","exa-answer","parallel"],"uniqueKey":"filters.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["model_channel_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["openai-0","openai-1","qwen-0","openai-2","perplexity-0","perplexity-1","google-0","google-1","google-2","google-3","google-4","google-5","anthropic-0","anthropic-1","anthropic-2","anthropic-3","deepseek-0","meta-0","meta-1","meta-2","xai-0","xai-1","microsoft-0","amazon-0","mistral-0","mistral-1","naver-0","openai-3","openai-4","openai-5","baidu-0","exa-0","parallel-0","microsoft-1","openai-6"],"uniqueKey":"filters.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.2.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["topic_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.3.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["prompt_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.4.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["country_code"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["AE","AL","AM","AR","AT","AU","BA","BE","BG","BH","BO","BR","BS","BY","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","EC","EE","EG","ES","FI","FR","GB","GE","GH","GR","GT","HK","HN","HR","HU","ID","IE","IL","IN","IQ","IS","IT","JO","JP","KR","KW","LB","LI","LT","LU","LV","MA","MD","ME","MK","MN","MT","MX","MY","NG","NI","NL","NO","NZ","OM","PK","PA","PE","PH","PL","PT","PY","PR","PS","QA","RO","RS","SA","SE","SG","SI","SK","SR","SV","TH","TN","TR","TW","UA","US","UY","VE","VN","ZA","AD","AF","AS","AZ","BB","BQ","CG","CI","CM","CW","DM","DZ","FO","GF","GP","JM","KG","KH","KI","KZ","LK","LR","LS","MW","NC","PG","TD","TF","UG","VU","ZW"],"uniqueKey":"filters.items.[INDEX].oneOf.5.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["chat_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.6.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.7.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_classification"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.8.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (CORPORATE, EDITORIAL, INSTITUTIONAL, OTHER, REFERENCE, UGC, COMPETITOR, OWN, RELATED) or a custom domain classification name.","example":["CORPORATE","EDITORIAL","INSTITUTIONAL","OTHER","REFERENCE","UGC","COMPETITOR","OWN","RELATED"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.9.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_classification"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.10.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or a custom URL classification name.","example":["HOMEPAGE","CATEGORY_PAGE","PRODUCT_PAGE","LISTICLE","COMPARISON","PROFILE","ALTERNATIVE","DISCUSSION","HOW_TO_GUIDE","ARTICLE","REVIEW","OTHER"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["mentioned_brand_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.11.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["mentioned_brand_count"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.value","typeLabel":"integer"}},"uniqueKey":"filters.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["gap"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.value","typeLabel":"integer"}},"uniqueKey":"filters.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.14.values.items.[INDEX]","typeLabel":"string"},"description":"Source tag ids. `in` keeps URLs carrying any of them, `has_all` keeps URLs carrying every one of them, `not_in` keeps URLs carrying none of them.","example":["stg_23abec5b-100a-4261-9ee7-1effe68f0149"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.15.values.items.[INDEX]","typeLabel":"string"},"description":"Source tag ids. `in` keeps sources on domains carrying any of them, `has_all` keeps sources on domains carrying every one of them, `not_in` keeps sources on domains carrying none of them.","example":["stg_23abec5b-100a-4261-9ee7-1effe68f0149"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.15","typeLabel":"object"}],"uniqueKey":"filters.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters","typeLabel":"object[]"},"having":{"description":"Post-aggregation row filters (applied as HAVING after grouping). Select which aggregated URL rows are returned. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap` — population fields require the matching value in `dimensions`. Multiple filters are AND'd.","example":[{"field":"url","operator":"in","values":["https://example.com/page"]}],"type":"array","items":{"oneOf":[{"type":"object","description":"Deprecated: use model_channel_id filter instead","required":["field","operator","values"],"deprecated":true,"properties":{"field":{"type":"string","enum":["model_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["chatgpt-scraper","gpt-4o","gpt-4o-search","gpt-3.5-turbo","llama-sonar","perplexity-scraper","sonar","gemini-2.5-flash","gemini-3.1-flash-lite-search","gemini-scraper","google-ai-overview-scraper","google-ai-mode-scraper","llama-3.3-70b-instruct","deepseek-r1","deepseek-v4-pro","claude-3.5-haiku","claude-haiku-4.5","claude-sonnet-4","grok-scraper","microsoft-copilot-scraper","copilot-search-scraper","chatgpt-logged-in-scraper","grok-4","grok-4.3","grok-4.6","qwen-3-6-plus","qwen-3-7-plus","amazon-rufus-scraper","mistral-small-4","mistral-medium-3-5","muse-spark-1.2","muse-spark-1.3","muse-wonder-1.0","gemini-4-argon","naver-ai-briefing-scraper","claude-opus-5","claude-fable-5.1","gpt-6-astra","gpt-5.6-sol","gpt-5.6-terra","ernie-scraper","exa-answer","parallel"],"uniqueKey":"having.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["model_channel_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["openai-0","openai-1","qwen-0","openai-2","perplexity-0","perplexity-1","google-0","google-1","google-2","google-3","google-4","google-5","anthropic-0","anthropic-1","anthropic-2","anthropic-3","deepseek-0","meta-0","meta-1","meta-2","xai-0","xai-1","microsoft-0","amazon-0","mistral-0","mistral-1","naver-0","openai-3","openai-4","openai-5","baidu-0","exa-0","parallel-0","microsoft-1","openai-6"],"uniqueKey":"having.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["tag_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.2.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["topic_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.3.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["prompt_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.4.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["country_code"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["AE","AL","AM","AR","AT","AU","BA","BE","BG","BH","BO","BR","BS","BY","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","EC","EE","EG","ES","FI","FR","GB","GE","GH","GR","GT","HK","HN","HR","HU","ID","IE","IL","IN","IQ","IS","IT","JO","JP","KR","KW","LB","LI","LT","LU","LV","MA","MD","ME","MK","MN","MT","MX","MY","NG","NI","NL","NO","NZ","OM","PK","PA","PE","PH","PL","PT","PY","PR","PS","QA","RO","RS","SA","SE","SG","SI","SK","SR","SV","TH","TN","TR","TW","UA","US","UY","VE","VN","ZA","AD","AF","AS","AZ","BB","BQ","CG","CI","CM","CW","DM","DZ","FO","GF","GP","JM","KG","KH","KI","KZ","LK","LR","LS","MW","NC","PG","TD","TF","UG","VU","ZW"],"uniqueKey":"having.items.[INDEX].oneOf.5.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["chat_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.6.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.7.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_classification"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.8.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (CORPORATE, EDITORIAL, INSTITUTIONAL, OTHER, REFERENCE, UGC, COMPETITOR, OWN, RELATED) or a custom domain classification name.","example":["CORPORATE","EDITORIAL","INSTITUTIONAL","OTHER","REFERENCE","UGC","COMPETITOR","OWN","RELATED"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.9.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_classification"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.10.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or a custom URL classification name.","example":["HOMEPAGE","CATEGORY_PAGE","PRODUCT_PAGE","LISTICLE","COMPARISON","PROFILE","ALTERNATIVE","DISCUSSION","HOW_TO_GUIDE","ARTICLE","REVIEW","OTHER"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["mentioned_brand_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.11.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["mentioned_brand_count"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.value","typeLabel":"integer"}},"uniqueKey":"having.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["gap"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.value","typeLabel":"integer"}},"uniqueKey":"having.items.[INDEX].oneOf.13","typeLabel":"object"}],"uniqueKey":"having.items.[INDEX]","typeLabel":"object"},"uniqueKey":"having","typeLabel":"object[]"},"order_by":{"description":"Sort results by one or more fields. Multiple entries create a multi-key sort. Direction defaults to desc. When omitted, a default ordering is applied.","example":[{"field":"retrieval_count","direction":"desc"}],"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["retrieval_count","retrievals","citation_count","citation_rate","citation_position","gap_score","date","week","month"],"isRequired":true,"uniqueKey":"order_by.items.[INDEX].field","typeLabel":"enum\u003cstring>"},"direction":{"default":"desc","type":"string","enum":["asc","desc"],"uniqueKey":"order_by.items.[INDEX].direction","typeLabel":"enum\u003cstring>"}},"required":["field"],"uniqueKey":"order_by.items.[INDEX]","typeLabel":"object"},"uniqueKey":"order_by","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"project_id":"or_f45b94ba-5e35-4982-93ed-285e72ee14eb","limit":1000,"offset":0,"start_date":"2025-09-22","end_date":"2025-09-22","dimensions":["tag_id","model_id"],"filters":[{"field":"model_id","operator":"in","values":["gpt-4o-search"]}],"having":[{"field":"url","operator":"in","values":["https://example.com/page"]}],"order_by":[{"field":"retrieval_count","direction":"desc"}]}}},"exampleType":"generated"},"multipart/form-data":{"schema":{"type":"object","properties":{"project_id":{"description":"Required if using a company api key","example":"or_f45b94ba-5e35-4982-93ed-285e72ee14eb","type":"string","uniqueKey":"project_id","typeLabel":"string"},"limit":{"default":1000,"type":"integer","minimum":1,"maximum":10000,"uniqueKey":"limit","typeLabel":"integer"},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"offset","typeLabel":"integer"},"start_date":{"default":"2026-01-01","description":"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21","example":"2025-09-22","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"start_date","typeLabel":"string\u003cdate>"},"end_date":{"default":"2026-01-01","description":"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21","example":"2025-09-22","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"end_date","typeLabel":"string\u003cdate>"},"dimensions":{"example":["tag_id","model_id"],"description":"Dimensions to break down the report by.","type":"array","items":{"type":"string","enum":["prompt_id","model_id","model_channel_id","tag_id","topic_id","date","week","month","country_code","chat_id"],"uniqueKey":"dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"dimensions","typeLabel":"enum\u003cstring>[]"},"filters":{"description":"Pre-aggregation row filters (applied as WHERE before grouping). Restrict which raw source-rows feed into the per-URL aggregation. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap`, `url_tag_id`, `domain_tag_id`. Multiple filters are AND'd.","example":[{"field":"model_id","operator":"in","values":["gpt-4o-search"]}],"type":"array","items":{"oneOf":[{"type":"object","description":"Deprecated: use model_channel_id filter instead","required":["field","operator","values"],"deprecated":true,"properties":{"field":{"type":"string","enum":["model_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["chatgpt-scraper","gpt-4o","gpt-4o-search","gpt-3.5-turbo","llama-sonar","perplexity-scraper","sonar","gemini-2.5-flash","gemini-3.1-flash-lite-search","gemini-scraper","google-ai-overview-scraper","google-ai-mode-scraper","llama-3.3-70b-instruct","deepseek-r1","deepseek-v4-pro","claude-3.5-haiku","claude-haiku-4.5","claude-sonnet-4","grok-scraper","microsoft-copilot-scraper","copilot-search-scraper","chatgpt-logged-in-scraper","grok-4","grok-4.3","grok-4.6","qwen-3-6-plus","qwen-3-7-plus","amazon-rufus-scraper","mistral-small-4","mistral-medium-3-5","muse-spark-1.2","muse-spark-1.3","muse-wonder-1.0","gemini-4-argon","naver-ai-briefing-scraper","claude-opus-5","claude-fable-5.1","gpt-6-astra","gpt-5.6-sol","gpt-5.6-terra","ernie-scraper","exa-answer","parallel"],"uniqueKey":"filters.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.0.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["model_channel_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["openai-0","openai-1","qwen-0","openai-2","perplexity-0","perplexity-1","google-0","google-1","google-2","google-3","google-4","google-5","anthropic-0","anthropic-1","anthropic-2","anthropic-3","deepseek-0","meta-0","meta-1","meta-2","xai-0","xai-1","microsoft-0","amazon-0","mistral-0","mistral-1","naver-0","openai-3","openai-4","openai-5","baidu-0","exa-0","parallel-0","microsoft-1","openai-6"],"uniqueKey":"filters.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.1.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.2.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.2.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["topic_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.3.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.3.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["prompt_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.4.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.4.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["country_code"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["AE","AL","AM","AR","AT","AU","BA","BE","BG","BH","BO","BR","BS","BY","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","EC","EE","EG","ES","FI","FR","GB","GE","GH","GR","GT","HK","HN","HR","HU","ID","IE","IL","IN","IQ","IS","IT","JO","JP","KR","KW","LB","LI","LT","LU","LV","MA","MD","ME","MK","MN","MT","MX","MY","NG","NI","NL","NO","NZ","OM","PK","PA","PE","PH","PL","PT","PY","PR","PS","QA","RO","RS","SA","SE","SG","SI","SK","SR","SV","TH","TN","TR","TW","UA","US","UY","VE","VN","ZA","AD","AF","AS","AZ","BB","BQ","CG","CI","CM","CW","DM","DZ","FO","GF","GP","JM","KG","KH","KI","KZ","LK","LR","LS","MW","NC","PG","TD","TF","UG","VU","ZW"],"uniqueKey":"filters.items.[INDEX].oneOf.5.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.5.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["chat_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.6.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.6.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.7.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.7.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_classification"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.8.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (CORPORATE, EDITORIAL, INSTITUTIONAL, OTHER, REFERENCE, UGC, COMPETITOR, OWN, RELATED) or a custom domain classification name.","example":["CORPORATE","EDITORIAL","INSTITUTIONAL","OTHER","REFERENCE","UGC","COMPETITOR","OWN","RELATED"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.8.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.9.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.9.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_classification"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.10.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or a custom URL classification name.","example":["HOMEPAGE","CATEGORY_PAGE","PRODUCT_PAGE","LISTICLE","COMPARISON","PROFILE","ALTERNATIVE","DISCUSSION","HOW_TO_GUIDE","ARTICLE","REVIEW","OTHER"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.10.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["mentioned_brand_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.11.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.11.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["mentioned_brand_count"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.12.value","typeLabel":"integer"}},"uniqueKey":"filters.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["gap"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.13.value","typeLabel":"integer"}},"uniqueKey":"filters.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.14.values.items.[INDEX]","typeLabel":"string"},"description":"Source tag ids. `in` keeps URLs carrying any of them, `has_all` keeps URLs carrying every one of them, `not_in` keeps URLs carrying none of them.","example":["stg_23abec5b-100a-4261-9ee7-1effe68f0149"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.14.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_tag_id"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"filters.items.[INDEX].oneOf.15.values.items.[INDEX]","typeLabel":"string"},"description":"Source tag ids. `in` keeps sources on domains carrying any of them, `has_all` keeps sources on domains carrying every one of them, `not_in` keeps sources on domains carrying none of them.","example":["stg_23abec5b-100a-4261-9ee7-1effe68f0149"],"isRequired":true,"uniqueKey":"filters.items.[INDEX].oneOf.15.values","typeLabel":"string[]"}},"uniqueKey":"filters.items.[INDEX].oneOf.15","typeLabel":"object"}],"uniqueKey":"filters.items.[INDEX]","typeLabel":"object"},"uniqueKey":"filters","typeLabel":"object[]"},"having":{"description":"Post-aggregation row filters (applied as HAVING after grouping). Select which aggregated URL rows are returned. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `domain`, `domain_classification`, `url`, `url_classification`, `mentioned_brand_id`, `mentioned_brand_count`, `gap` — population fields require the matching value in `dimensions`. Multiple filters are AND'd.","example":[{"field":"url","operator":"in","values":["https://example.com/page"]}],"type":"array","items":{"oneOf":[{"type":"object","description":"Deprecated: use model_channel_id filter instead","required":["field","operator","values"],"deprecated":true,"properties":{"field":{"type":"string","enum":["model_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["chatgpt-scraper","gpt-4o","gpt-4o-search","gpt-3.5-turbo","llama-sonar","perplexity-scraper","sonar","gemini-2.5-flash","gemini-3.1-flash-lite-search","gemini-scraper","google-ai-overview-scraper","google-ai-mode-scraper","llama-3.3-70b-instruct","deepseek-r1","deepseek-v4-pro","claude-3.5-haiku","claude-haiku-4.5","claude-sonnet-4","grok-scraper","microsoft-copilot-scraper","copilot-search-scraper","chatgpt-logged-in-scraper","grok-4","grok-4.3","grok-4.6","qwen-3-6-plus","qwen-3-7-plus","amazon-rufus-scraper","mistral-small-4","mistral-medium-3-5","muse-spark-1.2","muse-spark-1.3","muse-wonder-1.0","gemini-4-argon","naver-ai-briefing-scraper","claude-opus-5","claude-fable-5.1","gpt-6-astra","gpt-5.6-sol","gpt-5.6-terra","ernie-scraper","exa-answer","parallel"],"uniqueKey":"having.items.[INDEX].oneOf.0.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.0.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["model_channel_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["openai-0","openai-1","qwen-0","openai-2","perplexity-0","perplexity-1","google-0","google-1","google-2","google-3","google-4","google-5","anthropic-0","anthropic-1","anthropic-2","anthropic-3","deepseek-0","meta-0","meta-1","meta-2","xai-0","xai-1","microsoft-0","amazon-0","mistral-0","mistral-1","naver-0","openai-3","openai-4","openai-5","baidu-0","exa-0","parallel-0","microsoft-1","openai-6"],"uniqueKey":"having.items.[INDEX].oneOf.1.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.1.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["tag_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in","has_all"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.2.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.2.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["topic_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.3.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.3.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["prompt_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.4.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.4.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["country_code"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","enum":["AE","AL","AM","AR","AT","AU","BA","BE","BG","BH","BO","BR","BS","BY","CA","CH","CL","CN","CO","CR","CY","CZ","DE","DK","DO","EC","EE","EG","ES","FI","FR","GB","GE","GH","GR","GT","HK","HN","HR","HU","ID","IE","IL","IN","IQ","IS","IT","JO","JP","KR","KW","LB","LI","LT","LU","LV","MA","MD","ME","MK","MN","MT","MX","MY","NG","NI","NL","NO","NZ","OM","PK","PA","PE","PH","PL","PT","PY","PR","PS","QA","RO","RS","SA","SE","SG","SI","SK","SR","SV","TH","TN","TR","TW","UA","US","UY","VE","VN","ZA","AD","AF","AS","AZ","BB","BQ","CG","CI","CM","CW","DM","DZ","FO","GF","GP","JM","KG","KH","KI","KZ","LK","LR","LS","MW","NC","PG","TD","TF","UG","VU","ZW"],"uniqueKey":"having.items.[INDEX].oneOf.5.values.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.5.values","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"having.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["chat_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.6.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.6.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.7.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.7.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["domain_classification"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.8.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (CORPORATE, EDITORIAL, INSTITUTIONAL, OTHER, REFERENCE, UGC, COMPETITOR, OWN, RELATED) or a custom domain classification name.","example":["CORPORATE","EDITORIAL","INSTITUTIONAL","OTHER","REFERENCE","UGC","COMPETITOR","OWN","RELATED"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.8.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.9.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.9.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["url_classification"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.10.values.items.[INDEX]","typeLabel":"string"},"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or a custom URL classification name.","example":["HOMEPAGE","CATEGORY_PAGE","PRODUCT_PAGE","LISTICLE","COMPARISON","PROFILE","ALTERNATIVE","DISCUSSION","HOW_TO_GUIDE","ARTICLE","REVIEW","OTHER"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.10.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","required":["field","operator","values"],"properties":{"field":{"type":"string","enum":["mentioned_brand_id"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["in","not_in"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.operator","typeLabel":"enum\u003cstring>"},"values":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"having.items.[INDEX].oneOf.11.values.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.11.values","typeLabel":"string[]"}},"uniqueKey":"having.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["mentioned_brand_count"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.12.value","typeLabel":"integer"}},"uniqueKey":"having.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","enum":["gap"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.field","typeLabel":"enum\u003cstring>"},"operator":{"type":"string","enum":["gt","gte","lt","lte"],"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"having.items.[INDEX].oneOf.13.value","typeLabel":"integer"}},"uniqueKey":"having.items.[INDEX].oneOf.13","typeLabel":"object"}],"uniqueKey":"having.items.[INDEX]","typeLabel":"object"},"uniqueKey":"having","typeLabel":"object[]"},"order_by":{"description":"Sort results by one or more fields. Multiple entries create a multi-key sort. Direction defaults to desc. When omitted, a default ordering is applied.","example":[{"field":"retrieval_count","direction":"desc"}],"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["retrieval_count","retrievals","citation_count","citation_rate","citation_position","gap_score","date","week","month"],"isRequired":true,"uniqueKey":"order_by.items.[INDEX].field","typeLabel":"enum\u003cstring>"},"direction":{"default":"desc","type":"string","enum":["asc","desc"],"uniqueKey":"order_by.items.[INDEX].direction","typeLabel":"enum\u003cstring>"}},"required":["field"],"uniqueKey":"order_by.items.[INDEX]","typeLabel":"object"},"uniqueKey":"order_by","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"project_id":"or_f45b94ba-5e35-4982-93ed-285e72ee14eb","limit":1000,"offset":0,"start_date":"2025-09-22","end_date":"2025-09-22","dimensions":["tag_id","model_id"],"filters":[{"field":"model_id","operator":"in","values":["gpt-4o-search"]}],"having":[{"field":"url","operator":"in","values":["https://example.com/page"]}],"order_by":[{"field":"retrieval_count","direction":"desc"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"9cb0f067-a33c-4a22-853f-e3ee5295e1b0":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","example":"https://example.com/blog/page1#header","isRequired":true,"uniqueKey":"data.items.[INDEX].url","typeLabel":"string"},"classification":{"oneOf":[{"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or the name of a custom URL classification.","example":"HOMEPAGE","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].classification.oneOf.0","typeLabel":"string"},{"description":"Built-in classification (HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, REVIEW, OTHER) or the name of a custom URL classification.","example":"HOMEPAGE","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].classification.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].classification","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].title","typeLabel":"string | null"},"usage_count":{"type":"number","example":8,"deprecated":true,"description":"Deprecated: use retrieval_count instead","isRequired":true,"uniqueKey":"data.items.[INDEX].usage_count","typeLabel":"number"},"citation_count":{"type":"number","example":4,"isRequired":true,"uniqueKey":"data.items.[INDEX].citation_count","typeLabel":"number"},"citation_avg":{"type":"number","example":2.5,"deprecated":true,"description":"Deprecated: use citation_rate instead","isRequired":true,"uniqueKey":"data.items.[INDEX].citation_avg","typeLabel":"number"},"retrievals":{"type":"number","example":8,"deprecated":true,"description":"Deprecated: use retrieval_count instead","isRequired":true,"uniqueKey":"data.items.[INDEX].retrievals","typeLabel":"number"},"retrieval_count":{"type":"number","example":8,"description":"Total number of distinct chats that retrieved this URL","isRequired":true,"uniqueKey":"data.items.[INDEX].retrieval_count","typeLabel":"number"},"citation_rate":{"type":"number","example":0.5,"isRequired":true,"uniqueKey":"data.items.[INDEX].citation_rate","typeLabel":"number"},"citation_position":{"oneOf":[{"example":2.4,"description":"Average rank of this URL among the sources each chat cited inline, ordered by first inline citation; 1 is the first source cited. Averaged over the chats that cited this URL, and null when none did.","type":"number","isRequired":true,"uniqueKey":"data.items.[INDEX].citation_position.oneOf.0","typeLabel":"number"},{"example":2.4,"description":"Average rank of this URL among the sources each chat cited inline, ordered by first inline citation; 1 is the first source cited. Averaged over the chats that cited this URL, and null when none did.","type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].citation_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].citation_position","typeLabel":"number | null"},"citation_position_sum":{"type":"number","example":12,"description":"Sum of this URL's per-chat citation ranks; divide by citation_position_count to aggregate citation_position across results.","isRequired":true,"uniqueKey":"data.items.[INDEX].citation_position_sum","typeLabel":"number"},"citation_position_count":{"type":"number","example":5,"description":"Number of chats that cited this URL inline.","isRequired":true,"uniqueKey":"data.items.[INDEX].citation_position_count","typeLabel":"number"},"gap_score":{"type":"number","example":6,"description":"Competitor mentions on this URL's retrievals that do not mention your own brand, summed over every chat that retrieved it. Matches the Gap score of the Gap analysis page, which ranks URLs by it.","isRequired":true,"uniqueKey":"data.items.[INDEX].gap_score","typeLabel":"number"},"mentioned_brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].mentioned_brands.items.[INDEX].id","typeLabel":"string"}},"required":["id"],"uniqueKey":"data.items.[INDEX].mentioned_brands.items.[INDEX]","typeLabel":"object"},"description":"Brand IDs mentioned alongside this URL","isRequired":true,"uniqueKey":"data.items.[INDEX].mentioned_brands","typeLabel":"object[]"},"channel_title":{"oneOf":[{"description":"Channel or author name (e.g. YouTube channel, subreddit)","type":"string","uniqueKey":"data.items.[INDEX].channel_title.oneOf.0","typeLabel":"string"},{"description":"Channel or author name (e.g. YouTube channel, subreddit)","type":"null","uniqueKey":"data.items.[INDEX].channel_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].channel_title","typeLabel":"string | null"},"prompt":{"type":"object","properties":{"id":{"type":"string","example":"pr_93f790de-5b7a-45ee-b782-61103c81f20d","isRequired":true,"uniqueKey":"data.items.[INDEX].prompt.id","typeLabel":"string"}},"required":["id"],"uniqueKey":"data.items.[INDEX].prompt","typeLabel":"object"},"model":{"deprecated":true,"description":"Deprecated: use model_channel instead","type":"object","properties":{"id":{"type":"string","example":"gpt-4o-search","isRequired":true,"uniqueKey":"data.items.[INDEX].model.id","typeLabel":"string"}},"required":["id"],"uniqueKey":"data.items.[INDEX].model","typeLabel":"object"},"model_channel":{"type":"object","properties":{"id":{"type":"string","example":"openai-1","isRequired":true,"uniqueKey":"data.items.[INDEX].model_channel.id","typeLabel":"string"}},"required":["id"],"uniqueKey":"data.items.[INDEX].model_channel","typeLabel":"object"},"tag":{"type":"object","properties":{"id":{"type":"string","example":"tg_23abec5b-100a-4261-9ee7-1effe68f0149","isRequired":true,"uniqueKey":"data.items.[INDEX].tag.id","typeLabel":"string"}},"required":["id"],"uniqueKey":"data.items.[INDEX].tag","typeLabel":"object"},"topic":{"type":"object","properties":{"id":{"type":"string","example":"to_e6b8cdd3-a51b-4d94-a866-28dbe6b830a6","isRequired":true,"uniqueKey":"data.items.[INDEX].topic.id","typeLabel":"string"}},"required":["id"],"uniqueKey":"data.items.[INDEX].topic","typeLabel":"object"},"country_code":{"example":"US","type":"string","uniqueKey":"data.items.[INDEX].country_code","typeLabel":"string"},"chat":{"type":"object","properties":{"id":{"type":"string","example":"ch_abc123","isRequired":true,"uniqueKey":"data.items.[INDEX].chat.id","typeLabel":"string"}},"required":["id"],"uniqueKey":"data.items.[INDEX].chat","typeLabel":"object"},"date":{"type":"string","uniqueKey":"data.items.[INDEX].date","typeLabel":"string"},"week":{"example":"2025-03-10","description":"Start (Monday) of the ISO week bucket.","type":"string","uniqueKey":"data.items.[INDEX].week","typeLabel":"string"},"month":{"example":"2025-03-01","description":"First day of the month bucket.","type":"string","uniqueKey":"data.items.[INDEX].month","typeLabel":"string"}},"required":["url","classification","title","usage_count","citation_count","citation_avg","retrievals","retrieval_count","citation_rate","citation_position","citation_position_sum","citation_position_count","gap_score","mentioned_brands"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["data"],"description":"Success","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"url":"https://example.com/blog/page1#header","classification":"HOMEPAGE","title":"\u003cstring>","usage_count":8,"citation_count":4,"citation_avg":2.5,"retrievals":8,"retrieval_count":8,"citation_rate":0.5,"citation_position":2.4,"citation_position_sum":12,"citation_position_count":5,"gap_score":6,"mentioned_brands":[{"id":"\u003cstring>"}],"channel_title":"\u003cstring>","prompt":{"id":"pr_93f790de-5b7a-45ee-b782-61103c81f20d"},"model":{"id":"gpt-4o-search"},"model_channel":{"id":"openai-1"},"tag":{"id":"tg_23abec5b-100a-4261-9ee7-1effe68f0149"},"topic":{"id":"to_e6b8cdd3-a51b-4d94-a866-28dbe6b830a6"},"country_code":"US","chat":{"id":"ch_abc123"},"date":"\u003cstring>","week":"2025-03-10","month":"2025-03-01"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"13cc489c-19d4-424a-b542-1783a2bcbf4f":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"}},"026ed8f8-2ebf-4195-b481-a450da9781de":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"93546c49-a765-450f-84ae-564c3fccb791":{"url":"https://api.peec.ai/customer/v1"}},"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"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.peec.ai/customer/v1/openapi/json"},"subdomain":"peecai-b61a1960","siteName":"Peec.ai Docs","title":"Get URLs Report - Peec.ai Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T16:04:45.591Z","originalFileLocation":"api-reference/reports/get-urls-report.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=\"Get a report on Source URLs. ## Prompt Scope The report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a prompt_id filter to narrow it. ## Aggregation Formulas When aggregating results across multiple rows/dimensions, use the following formula: - citation_rate: sum(citation_count) / sum(retrieval_count) - citation_position: sum(citation_position_sum) / sum(citation_position_count) ## filters vs having filters are pre-aggregation row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap, url_tag_id, domain_tag_id. - Population (model_id, model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id) shrink both numerator and denominator scope. - Source-side (domain, domain_classification, url, url_classification) and per-row mentioned-brand predicates (mentioned_brand_id, mentioned_brand_count, gap) shrink the source-row scope feeding aggregation. having are post-aggregation row filters (applied as HAVING after GROUP BY). Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap. citation_rate is computed per row from numerator (citation_count) and denominator (retrieval_count) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both filters and having — use filters to prune source rows before aggregation (typically more efficient), use having to operate on the aggregated mentioned_brands union for entity-wide selection.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Peec.ai 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/peecai-b61a1960/zMn2L1kVVj65q3Df/_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/peecai-b61a1960/zMn2L1kVVj65q3Df/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/peecai-b61a1960/zMn2L1kVVj65q3Df/_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/peecai-b61a1960/zMn2L1kVVj65q3Df/_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/peecai-b61a1960/zMn2L1kVVj65q3Df/_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/peecai-b61a1960/zMn2L1kVVj65q3Df/_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/peecai-b61a1960/zMn2L1kVVj65q3Df/_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/peecai-b61a1960/zMn2L1kVVj65q3Df/_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/peecai-b61a1960/zMn2L1kVVj65q3Df/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get URLs Report - Peec.ai Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a report on Source URLs. ## Prompt Scope The report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a prompt_id filter to narrow it. ## Aggregation Formulas When aggregating results across multiple rows/dimensions, use the following formula: - citation_rate: sum(citation_count) / sum(retrieval_count) - citation_position: sum(citation_position_sum) / sum(citation_position_count) ## filters vs having filters are pre-aggregation row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap, url_tag_id, domain_tag_id. - Population (model_id, model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id) shrink both numerator and denominator scope. - Source-side (domain, domain_classification, url, url_classification) and per-row mentioned-brand predicates (mentioned_brand_id, mentioned_brand_count, gap) shrink the source-row scope feeding aggregation. having are post-aggregation row filters (applied as HAVING after GROUP BY). Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap. citation_rate is computed per row from numerator (citation_count) and denominator (retrieval_count) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both filters and having — use filters to prune source rows before aggregation (typically more efficient), use having to operate on the aggregated mentioned_brands union for entity-wide selection.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Peec.ai Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.peec.ai/api-reference/reports/get-urls-report\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://peecai-b61a1960.mintlify.site/_mintlify/api/og/v2?division=Reports\u0026amp;title=Get+URLs+Report\u0026amp;description=Get+a+report+on+Source+URLs.%0A%0A%23%23+Prompt+Scope%0A%0AThe+report+covers+every+prompt+in+the+project+that+has+not+been+deleted%2C+archived+prompts+included%2C+so+history+st\u0026amp;theme=3497822b04003214442ec868\u0026amp;signature=57b592bf1d6880dc45b9ed227e376445bb7e159548520d9361c733b91fe36fa9\">\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 URLs Report - Peec.ai Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a report on Source URLs. ## Prompt Scope The report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a prompt_id filter to narrow it. ## Aggregation Formulas When aggregating results across multiple rows/dimensions, use the following formula: - citation_rate: sum(citation_count) / sum(retrieval_count) - citation_position: sum(citation_position_sum) / sum(citation_position_count) ## filters vs having filters are pre-aggregation row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap, url_tag_id, domain_tag_id. - Population (model_id, model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id) shrink both numerator and denominator scope. - Source-side (domain, domain_classification, url, url_classification) and per-row mentioned-brand predicates (mentioned_brand_id, mentioned_brand_count, gap) shrink the source-row scope feeding aggregation. having are post-aggregation row filters (applied as HAVING after GROUP BY). Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap. citation_rate is computed per row from numerator (citation_count) and denominator (retrieval_count) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both filters and having — use filters to prune source rows before aggregation (typically more efficient), use having to operate on the aggregated mentioned_brands union for entity-wide selection.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://peecai-b61a1960.mintlify.site/_mintlify/api/og/v2?division=Reports\u0026amp;title=Get+URLs+Report\u0026amp;description=Get+a+report+on+Source+URLs.%0A%0A%23%23+Prompt+Scope%0A%0AThe+report+covers+every+prompt+in+the+project+that+has+not+been+deleted%2C+archived+prompts+included%2C+so+history+st\u0026amp;theme=3497822b04003214442ec868\u0026amp;signature=57b592bf1d6880dc45b9ed227e376445bb7e159548520d9361c733b91fe36fa9\">\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/peecai-b61a1960/zMn2L1kVVj65q3Df/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Peec.ai Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.peec.ai/api-reference/reports/get-urls-report\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/reports/get-urls-report.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.peec.ai/#organization\",\"name\":\"Peec.ai Docs\",\"url\":\"https://docs.peec.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/peecai-b61a1960/BVQQX1wLWNjFOa_V/images/logo-white.svg?fit=max\u0026auto=format\u0026n=BVQQX1wLWNjFOa_V\u0026q=85\u0026s=5d3f30a498a2c71a875226adc1a9de52\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.peec.ai#website\",\"name\":\"Peec.ai Docs\",\"url\":\"https://docs.peec.ai\",\"publisher\":{\"@id\":\"https://docs.peec.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.peec.ai/api-reference/reports/get-urls-report#webpage\",\"url\":\"https://docs.peec.ai/api-reference/reports/get-urls-report\",\"name\":\"Get URLs Report\",\"description\":\"Get a report on Source URLs. ## Prompt Scope The report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a prompt_id filter to narrow it. ## Aggregation Formulas When aggregating results across multiple rows/dimensions, use the following formula: - citation_rate: sum(citation_count) / sum(retrieval_count) - citation_position: sum(citation_position_sum) / sum(citation_position_count) ## filters vs having filters are pre-aggregation row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap, url_tag_id, domain_tag_id. - Population (model_id, model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id) shrink both numerator and denominator scope. - Source-side (domain, domain_classification, url, url_classification) and per-row mentioned-brand predicates (mentioned_brand_id, mentioned_brand_count, gap) shrink the source-row scope feeding aggregation. having are post-aggregation row filters (applied as HAVING after GROUP BY). Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap. citation_rate is computed per row from numerator (citation_count) and denominator (retrieval_count) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both filters and having — use filters to prune source rows before aggregation (typically more efficient), use having to operate on the aggregated mentioned_brands union for entity-wide selection.\",\"dateModified\":\"2026-11-19T16:04:45.591Z\",\"isPartOf\":{\"@id\":\"https://docs.peec.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.peec.ai/api-reference/reports/get-urls-report#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.peec.ai/api-reference/reports/get-urls-report#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.peec.ai/api-reference/reports/get-brands-report\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Reports\",\"item\":\"https://docs.peec.ai/api-reference/reports/get-brands-report\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get URLs Report\",\"item\":\"https://docs.peec.ai/api-reference/reports/get-urls-report\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.peec.ai/api-reference/reports/get-urls-report#apireference\",\"headline\":\"Get URLs Report\",\"name\":\"Get URLs Report\",\"description\":\"Get a report on Source URLs. ## Prompt Scope The report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a prompt_id filter to narrow it. ## Aggregation Formulas When aggregating results across multiple rows/dimensions, use the following formula: - citation_rate: sum(citation_count) / sum(retrieval_count) - citation_position: sum(citation_position_sum) / sum(citation_position_count) ## filters vs having filters are pre-aggregation row filters (applied as WHERE before GROUP BY) on the source-row table. Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap, url_tag_id, domain_tag_id. - Population (model_id, model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id) shrink both numerator and denominator scope. - Source-side (domain, domain_classification, url, url_classification) and per-row mentioned-brand predicates (mentioned_brand_id, mentioned_brand_count, gap) shrink the source-row scope feeding aggregation. having are post-aggregation row filters (applied as HAVING after GROUP BY). Allowed fields: model_id (deprecated), model_channel_id, country_code, prompt_id, tag_id, topic_id, chat_id, domain, domain_classification, url, url_classification, mentioned_brand_id, mentioned_brand_count, gap. citation_rate is computed per row from numerator (citation_count) and denominator (retrieval_count) inside the same aggregation group, so neither filter placement can collapse it. The shared fields exist in both filters and having — use filters to prune source rows before aggregation (typically more efficient), use having to operate on the aggregated mentioned_brands union for entity-wide selection.\",\"url\":\"https://docs.peec.ai/api-reference/reports/get-urls-report\",\"mainEntityOfPage\":{\"@id\":\"https://docs.peec.ai/api-reference/reports/get-urls-report#webpage\"},\"dateModified\":\"2026-11-19T16:04:45.591Z\",\"publisher\":{\"@id\":\"https://docs.peec.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.peec.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Peec.ai Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Peec.ai Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/reports/get-urls-report.md","siteName":"Peec.ai Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"newspaper","pages":[{"title":"Documentation","href":"/intro-to-peec-ai"}]},{"tab":"Agencies","icon":"handshake","pages":[{"title":"Agencies","href":"/agencies/agency-getting-started"}]},{"tab":"MCP Server","icon":"plug","pages":[{"title":"MCP Server","href":"/mcp/introduction"}]},{"tab":"Customer API","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"Introduction to Peec API","sidebarTitle":"Introduction","icon":"book","href":"/api/introduction"},{"title":"Authentication for Peec API","sidebarTitle":"Authentication","icon":"lock","href":"/api/authentication"},{"title":"Rate Limits for Peec API","sidebarTitle":"Rate Limits","icon":"timer","href":"/api/ratelimits"},{"title":"Model channels","sidebarTitle":"Model Channels","icon":"tags","href":"/api/model-channels"},{"title":"Filtering and dimensions","sidebarTitle":"Filtering \u0026 Dimensions","icon":"filter","href":"/api/filtering-and-dimensions"},{"title":"Changelog","icon":"list","sidebarTitle":"Changelog","href":"/api/changelog"}]},{"group":"Endpoints","pages":[{"group":"Reports","pages":[{"title":"Get Brands Report","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /reports/brands","href":"/api-reference/reports/get-brands-report"},{"title":"Get Domains Report","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /reports/domains","href":"/api-reference/reports/get-domains-report"},{"title":"Get Links Report","description":"Get a report on the domains AI answers linked to in their own text. A link is a URL the answer wrote into its prose; it is never one of the sources the answer retrieved or cited, which the domains report covers.\n\n## Prompt Scope\n\nThe report covers every prompt in the project that has not been deleted, archived prompts included, so history stays intact after a prompt is archived. Use a `prompt_id` filter to narrow it.\n\n## Aggregation Formulas\n\nWhen aggregating results across multiple rows/dimensions:\n\n- **linked_percentage**: `sum(linked_chat_count) / sum(total_chat_count)`, only across rows that do not split the same chats (not across `url` rows of one domain).\n- **average_link_position** is not additive across rows. Request the coarser breakdown instead.","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /reports/links","href":"/api-reference/reports/get-links-report"},{"title":"Get URLs Report","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /reports/urls","href":"/api-reference/reports/get-urls-report"},{"title":"Get URL Content","description":"Return the scraped markdown content of a source URL. Use the URLs report to discover URLs.","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /sources/urls/content","href":"/api-reference/reports/get-url-content"},{"title":"List URL Content Versions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /sources/urls/content/versions","href":"/api-reference/reports/list-url-content-versions"},{"title":"Get URL Content Diff","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /sources/urls/content/diff","href":"/api-reference/reports/get-url-content-diff"}]},{"group":"Project","pages":[{"title":"List Fanout Search Queries","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /queries/search","href":"/api-reference/project/list-fanout-search-queries"},{"title":"List Fanout Shopping Queries","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /queries/shopping","href":"/api-reference/project/list-fanout-shopping-queries"},{"title":"List Brands","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brands","href":"/api-reference/project/list-brands"},{"title":"Create Brand","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /brands","href":"/api-reference/project/create-brand"},{"title":"List Brand Social Channels","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brands/social-channels","href":"/api-reference/project/list-brand-social-channels"},{"title":"List Brand Suggestions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brands/suggestions","href":"/api-reference/project/list-brand-suggestions"},{"title":"Accept Brand Suggestion","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /brands/suggestions/{brand_suggestion_id}/accept","href":"/api-reference/project/accept-brand-suggestion"},{"title":"Reject Brand Suggestion","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /brands/suggestions/{brand_suggestion_id}/reject","href":"/api-reference/project/reject-brand-suggestion"},{"title":"Delete Brand","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /brands/{brand_id}","href":"/api-reference/project/delete-brand"},{"title":"Update Brand","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json patch /brands/{brand_id}","href":"/api-reference/project/update-brand"},{"title":"Set Brand Social Channels","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json put /brands/{brand_id}/social-channels","href":"/api-reference/project/set-brand-social-channels"},{"title":"List Prompts","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /prompts","href":"/api-reference/project/list-prompts"},{"title":"Create Prompt","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /prompts","href":"/api-reference/project/create-prompt"},{"title":"List Prompt Suggestions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /prompts/suggestions","href":"/api-reference/project/list-prompt-suggestions"},{"title":"Generate Prompt Suggestions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /prompts/suggestions/generate","href":"/api-reference/project/generate-prompt-suggestions"},{"title":"Get Prompt Suggestion Generation","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /prompts/suggestions/generations/{generation_id}","href":"/api-reference/project/get-prompt-suggestion-generation"},{"title":"Accept Prompt Suggestion","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /prompts/suggestions/{prompt_suggestion_id}/accept","href":"/api-reference/project/accept-prompt-suggestion"},{"title":"Reject Prompt Suggestion","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /prompts/suggestions/{prompt_suggestion_id}/reject","href":"/api-reference/project/reject-prompt-suggestion"},{"title":"Update Prompt Suggestions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /prompts/suggestions/update","href":"/api-reference/project/update-prompt-suggestions"},{"title":"Delete Prompt","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /prompts/{prompt_id}","href":"/api-reference/project/delete-prompt"},{"title":"Update Prompt","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json patch /prompts/{prompt_id}","href":"/api-reference/project/update-prompt"},{"title":"Archive Prompt","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /prompts/{prompt_id}/archive","href":"/api-reference/project/archive-prompt"},{"title":"Unarchive Prompt","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /prompts/{prompt_id}/unarchive","href":"/api-reference/project/unarchive-prompt"},{"title":"Invite Project Members","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /members/invite","href":"/api-reference/project/invite-project-members"},{"title":"List Tags","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /tags","href":"/api-reference/project/list-tags"},{"title":"Create Tag","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /tags","href":"/api-reference/project/create-tag"},{"title":"Delete Tag","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /tags/{tag_id}","href":"/api-reference/project/delete-tag"},{"title":"Update Tag","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json patch /tags/{tag_id}","href":"/api-reference/project/update-tag"},{"title":"List Tag Groups","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /tag-groups","href":"/api-reference/project/list-tag-groups"},{"title":"Delete Tag Group","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /tag-groups","href":"/api-reference/project/delete-tag-group"},{"title":"Update Tag Group","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json patch /tag-groups/{group}","href":"/api-reference/project/update-tag-group"},{"title":"List Topics","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /topics","href":"/api-reference/project/list-topics"},{"title":"Create Topic","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /topics","href":"/api-reference/project/create-topic"},{"title":"Generate Topics","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /topics/generate","href":"/api-reference/project/generate-topics"},{"title":"List Topic Suggestions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /topics/suggestions","href":"/api-reference/project/list-topic-suggestions"},{"title":"Accept Topic Suggestion","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /topics/suggestions/{topic_suggestion_id}/accept","href":"/api-reference/project/accept-topic-suggestion"},{"title":"Reject Topic Suggestion","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /topics/suggestions/{topic_suggestion_id}/reject","href":"/api-reference/project/reject-topic-suggestion"},{"title":"Delete Topic","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /topics/{topic_id}","href":"/api-reference/project/delete-topic"},{"title":"Update Topic","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json patch /topics/{topic_id}","href":"/api-reference/project/update-topic"},{"title":"List Models","deprecated":true,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /models","href":"/api-reference/project/list-models"},{"title":"List Model Channels","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /model-channels","href":"/api-reference/project/list-model-channels"},{"title":"List Bots","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /agent-analytics/bots","href":"/api-reference/project/list-bots"},{"title":"List Agent logs","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /agent-analytics/logs","href":"/api-reference/project/list-agent-logs"},{"title":"Get Agent Visits","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /agent-analytics/visits","href":"/api-reference/project/get-agent-visits"},{"title":"List Chats","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /chats","href":"/api-reference/project/list-chats"},{"title":"Get Chat","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /chats/{chat_id}/content","href":"/api-reference/project/get-chat"},{"title":"Get Project Profile","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /project-profile","href":"/api-reference/project/get-project-profile"},{"title":"Set Project Profile","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json put /project-profile","href":"/api-reference/project/set-project-profile"},{"title":"List Custom Domain Classifications","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /classifications/domains","href":"/api-reference/project/list-custom-domain-classifications"},{"title":"Create Custom Domain Classification","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /classifications/domains","href":"/api-reference/project/create-custom-domain-classification"},{"title":"Delete Custom Domain Classification","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /classifications/domains","href":"/api-reference/project/delete-custom-domain-classification"},{"title":"Set Domain Classification","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json put /classifications/domain-assignments","href":"/api-reference/project/set-domain-classification"},{"title":"List Custom URL Classifications","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /classifications/urls","href":"/api-reference/project/list-custom-url-classifications"},{"title":"Create Custom URL Classification","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /classifications/urls","href":"/api-reference/project/create-custom-url-classification"},{"title":"Delete Custom URL Classification","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /classifications/urls","href":"/api-reference/project/delete-custom-url-classification"},{"title":"Set URL Classification","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json put /classifications/url-assignments","href":"/api-reference/project/set-url-classification"},{"title":"List Source Tags","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /source-tags","href":"/api-reference/project/list-source-tags"},{"title":"Create Source Tag","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /source-tags","href":"/api-reference/project/create-source-tag"},{"title":"Delete Source Tag","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json delete /source-tags/{source_tag_id}","href":"/api-reference/project/delete-source-tag"},{"title":"Update Source Tag","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json patch /source-tags/{source_tag_id}","href":"/api-reference/project/update-source-tag"},{"title":"Update URL Source Tags","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json put /source-tags/url-assignments","href":"/api-reference/project/update-url-source-tags"},{"title":"Update Domain Source Tags","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json put /source-tags/domain-assignments","href":"/api-reference/project/update-domain-source-tags"}]},{"group":"Products","pages":[{"title":"List Products","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/list","href":"/api-reference/products/list-products"},{"title":"Get Product","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/detail","href":"/api-reference/products/get-product"},{"title":"Get Shopping Attributes","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/attributes","href":"/api-reference/products/get-shopping-attributes"},{"title":"Get Shopping Summary","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/summary","href":"/api-reference/products/get-shopping-summary"},{"title":"Get Shopping Trend","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/trend","href":"/api-reference/products/get-shopping-trend"},{"title":"List Shopping Performance","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/performance","href":"/api-reference/products/list-shopping-performance"},{"title":"List Shopping Demand","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/demand","href":"/api-reference/products/list-shopping-demand"},{"title":"List Merchants","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/merchants","href":"/api-reference/products/list-merchants"},{"title":"Create Products","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/create","href":"/api-reference/products/create-products"},{"title":"Update Products","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/update","href":"/api-reference/products/update-products"},{"title":"Delete Products","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /products/delete","href":"/api-reference/products/delete-products"},{"title":"List Categories","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /categories","href":"/api-reference/products/list-categories"},{"title":"Create Categories","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /categories/create","href":"/api-reference/products/create-categories"},{"title":"Update Categories","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /categories/update","href":"/api-reference/products/update-categories"},{"title":"Delete Categories","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /categories/delete","href":"/api-reference/products/delete-categories"},{"title":"List Global Brands","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /global-brands","href":"/api-reference/products/list-global-brands"},{"title":"Create Global Brand","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /global-brands","href":"/api-reference/products/create-global-brand"}]},{"group":"Actions","pages":[{"title":"List Actions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/list","href":"/api-reference/actions/list-actions"},{"title":"Get Action","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/detail","href":"/api-reference/actions/get-action"},{"title":"List Action Platforms","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/platforms","href":"/api-reference/actions/list-action-platforms"},{"title":"Create Actions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/create","href":"/api-reference/actions/create-actions"},{"title":"Update Actions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/update","href":"/api-reference/actions/update-actions"},{"title":"Delete Actions","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/delete","href":"/api-reference/actions/delete-actions"},{"title":"Update Action Status","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/status","href":"/api-reference/actions/update-action-status"},{"title":"Set Action Step Completion","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /actions/steps/completion","href":"/api-reference/actions/set-action-step-completion"}]},{"group":"Brand Perception","pages":[{"title":"Get Brand Perception Attributes","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/brand-attributes","href":"/api-reference/brand-perception/get-brand-perception-attributes"},{"title":"Get Brand Perception Attribute Rankings","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/attribute-rankings","href":"/api-reference/brand-perception/get-brand-perception-attribute-rankings"},{"title":"Get Brand Perception Attribute Sources","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/attribute-sources","href":"/api-reference/brand-perception/get-brand-perception-attribute-sources"},{"title":"Get Brand Perception Attribute History","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/attribute-history","href":"/api-reference/brand-perception/get-brand-perception-attribute-history"},{"title":"Get Brand Perception Competitive Breakdown","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/competitive-breakdown","href":"/api-reference/brand-perception/get-brand-perception-competitive-breakdown"},{"title":"Get Brand Perception Objections","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/objections","href":"/api-reference/brand-perception/get-brand-perception-objections"},{"title":"Get Brand Perception Objection Sources","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/objection-sources","href":"/api-reference/brand-perception/get-brand-perception-objection-sources"},{"title":"Get Brand Perception Fact-Checking Verdicts","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/fact-checking-verdicts","href":"/api-reference/brand-perception/get-brand-perception-fact-checking-verdicts"},{"title":"Get Brand Perception Claim Sources","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/claim-sources","href":"/api-reference/brand-perception/get-brand-perception-claim-sources"},{"title":"List Facts","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /facts","href":"/api-reference/brand-perception/list-facts"},{"title":"Create Facts","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /facts/create","href":"/api-reference/brand-perception/create-facts"},{"title":"Update Facts","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /facts/update","href":"/api-reference/brand-perception/update-facts"},{"title":"Delete Facts","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /facts/delete","href":"/api-reference/brand-perception/delete-facts"},{"title":"List Brand Perception Industries","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/industries","href":"/api-reference/brand-perception/list-brand-perception-industries"},{"title":"List Brand Perception Attribute Clusters","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /brand-perception/attribute-clusters","href":"/api-reference/brand-perception/list-brand-perception-attribute-clusters"},{"title":"Edit Brand Perception Attribute Clusters","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /brand-perception/attribute-clusters/edit","href":"/api-reference/brand-perception/edit-brand-perception-attribute-clusters"},{"title":"Create Brand Perception Attribute Clusters","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /brand-perception/attribute-clusters/create","href":"/api-reference/brand-perception/create-brand-perception-attribute-clusters"}]},{"group":"Agent Analytics","pages":[{"title":"Get Agent Readiness","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /agent-analytics/readiness","href":"/api-reference/agent-analytics/get-agent-readiness"},{"title":"Request Agent Readiness Audits","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /agent-analytics/readiness/audits","href":"/api-reference/agent-analytics/request-agent-readiness-audits"},{"title":"Get AI Referrals","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /agent-analytics/google-analytics/referrals","href":"/api-reference/agent-analytics/get-ai-referrals"},{"title":"List Referral Sources","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /agent-analytics/google-analytics/list-referral-sources","href":"/api-reference/agent-analytics/list-referral-sources"}]},{"group":"Company","pages":[{"title":"List Projects","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json get /projects","href":"/api-reference/company/list-projects"},{"title":"Create Project","deprecated":null,"version":null,"openapi":"https://api.peec.ai/customer/v1/openapi/json post /projects","href":"/api-reference/company/create-project"}]}]}]},{"tab":"Research","hidden":true,"searchable":true,"pages":[{"title":"Research","href":"/research/ai-bot-types"}]}]},"basePath":"","title":"Get URLs Report - Peec.ai Docs","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}