Retrieve query groups associated with a customer.
A query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups.
This endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.
Active — live, scanned on schedule, data available via API.Pause — scanning paused, still accessible via API, can be resumed.Not Active — fully disabled, no scanning, not available via API.
What is an Execution?
An execution is a single scan/run of all queries in a query group against a specific AI platform, producing visibility scores, competitor mentions, and source citations for each query. Executions run periodically and their results over time power the growth tracking and trend analysis.Each execution targets a single AI platform, indicated by the ai_platform field. A query group can have multiple executions per run — one per supported platform.
AI Platforms (ai_platform)
Each execution includes an ai_platform field indicating which AI platform it ran against. Current values:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mindshare AI","colors":{"primary":"#8B5CF6","light":"#A78BFA","dark":"#7C3AED"},"logo":{"light":"https://mintcdn.com/mindshare/rDFI1T0ZDib06cKe/logo/light1.svg?fit=max\u0026auto=format\u0026n=rDFI1T0ZDib06cKe\u0026q=85\u0026s=af7e774d5fe9f7d2d94066a2d2a6d844","dark":"https://mintcdn.com/mindshare/rDFI1T0ZDib06cKe/logo/dark1.svg?fit=max\u0026auto=format\u0026n=rDFI1T0ZDib06cKe\u0026q=85\u0026s=e92a97221227d914fb8d06354c812db2","href":"https://www.mindshare.so/"},"favicon":"https://mintcdn.com/mindshare/rDFI1T0ZDib06cKe/favicon.svg?fit=max\u0026auto=format\u0026n=rDFI1T0ZDib06cKe\u0026q=85\u0026s=00edc15dfc48c6d94f1e48602216d74b","navbar":{"links":[{"href":"mailto:ethan@mindshare.so","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.amionai.com/login"}},"footer":{"socials":{"website":"https://www.mindshare.so","linkedin":"https://www.linkedin.com/company/mindshareai"}},"integrations":{"gtm":{"tagId":"GTM-WB238KWS"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mindshare","hasAudioNarration":false,"actualSubdomain":"mindshare","customDomains":["docs.mindshare.so"],"gitSource":{"type":"github","owner":"pelegaran","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e8a9cf44a63d52c9b7d7","collectionId":"e9c82730-3366-465c-96e1-13a887ca6909","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21e8a9cf44a63d52c9b7d7:success","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Mindshare API","count":21},{"language":"default","tag":"Endpoints","count":16},{"language":"default","tag":"Data Retrieval","count":10},{"language":"default","tag":"Management","count":5},{"language":"default","tag":"API documentation","count":4},{"language":"default","tag":"Utilities","count":1},{"language":"default","tag":"Use Cases","count":1}]},"assistantConfig":{"enableStarterQuestions":false},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/get-customer-query-groups","slug":"/api-reference/endpoint/get-customer-query-groups","pageMetadata":{"title":"Get Query Groups","openapi":"POST /get-customer-query-groups","description":"Retrieve query groups associated with a customer.\nA query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups.\n\nThis endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.","href":"/api-reference/endpoint/get-customer-query-groups"},"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 p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieve query groups associated with a customer.\\nA query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"This endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);return _jsxs(_Fragment,{children:[_jsxs(Accordion,{title:`Query Group Statuses`,id:`query-group-statuses`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Active`}),` — live, scanned on schedule, data available via API.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Pause`}),` — scanning paused, still accessible via API, can be resumed.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Not Active`}),` — fully disabled, no scanning, not available via API.`]})]}),`\n`,_jsxs(Accordion,{title:`What is an Execution?`,id:`what-is-an-execution`,children:[_jsx(_components.p,{children:`An execution is a single scan/run of all queries in a query group against a specific AI platform, producing visibility scores, competitor mentions, and source citations for each query. Executions run periodically and their results over time power the growth tracking and trend analysis.`}),_jsxs(_components.p,{children:[`Each execution targets a single AI platform, indicated by the `,_jsx(_components.code,{children:`ai_platform`}),` field. A query group can have multiple executions per run — one per supported platform.`]})]}),`\n`,_jsxs(Accordion,{title:_jsxs(_Fragment,{children:[`AI Platforms (`,_jsx(_components.code,{children:`ai_platform`}),`)`]}),id:`ai-platforms-ai-platform`,children:[_jsxs(_components.p,{children:[`Each execution includes an `,_jsx(_components.code,{children:`ai_platform`}),` field indicating which AI platform it ran against. Current values:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`chatgpt`}),` — ChatGPT`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`aioverview`}),` — Google AI Overview`]}),`\n`]}),_jsx(_components.p,{children:`Additional platforms may be added in the future.`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Query Groups","openapi":"POST /get-customer-query-groups","description":"Retrieve query groups associated with a customer.\nA query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups.\n\nThis endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.","href":"/api-reference/endpoint/get-customer-query-groups"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Retrieve query groups associated with a customer.\nA query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups.\n\nThis endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.","requestBody":"66917a44-2fef-490a-9bdd-ee55b8e850b6","responses":{"200":"33ad96a0-82b0-41c6-a009-7b7cfe606624"},"method":"post","type":"path","servers":["5acce9d0-04b0-4a0e-be94-016b584dfc86"],"security":["f77b6360-c5d8-4263-8972-8cd949a79774"],"path":"/get-customer-query-groups","baseUrlOptions":["https://api.mindshare.so/customer/v1"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Customer ID","content":{"application/json":{"schema":{"type":"object","properties":{"customerID":{"type":"number","description":"The ID of the customer","isRequired":true,"uniqueKey":"customerID","typeLabel":"number"}},"required":["customerID"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customerID":123}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"33ad96a0-82b0-41c6-a009-7b7cfe606624":{"description":"List of query groups for the customer","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"query_group_id":{"type":"number","description":"Query group ID","isRequired":true,"uniqueKey":"data.items.[INDEX].query_group_id","typeLabel":"number"},"group_type":{"type":"string","description":"Type of the group","isRequired":true,"uniqueKey":"data.items.[INDEX].group_type","typeLabel":"string"},"created_time":{"type":"string","format":"date-time","description":"Creation timestamp","isRequired":true,"uniqueKey":"data.items.[INDEX].created_time","typeLabel":"string\u003cdate-time>"},"keywords":{"type":"string","description":"Keywords for the group","isRequired":true,"uniqueKey":"data.items.[INDEX].keywords","typeLabel":"string"},"website_url":{"type":"string","format":"uri","description":"Website URL","isRequired":true,"uniqueKey":"data.items.[INDEX].website_url","typeLabel":"string\u003curi>"},"run_from_location":{"type":"string","description":"Location to run from. Default is 'us'","isRequired":true,"uniqueKey":"data.items.[INDEX].run_from_location","typeLabel":"string"},"executions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Execution ID","isRequired":true,"uniqueKey":"data.items.[INDEX].executions.items.[INDEX].id","typeLabel":"number"},"title":{"type":"string","description":"Execution title","isRequired":true,"uniqueKey":"data.items.[INDEX].executions.items.[INDEX].title","typeLabel":"string"},"execution_date":{"type":"string","format":"date","description":"Date of execution","isRequired":true,"uniqueKey":"data.items.[INDEX].executions.items.[INDEX].execution_date","typeLabel":"string\u003cdate>"},"score":{"type":"number","description":"Execution score","isRequired":true,"uniqueKey":"data.items.[INDEX].executions.items.[INDEX].score","typeLabel":"number"},"ai_platform":{"type":"string","description":"AI platform this execution ran against. Current values: 'chatgpt' (ChatGPT), 'aioverview' (Google AI Overview). Additional platforms may be added in the future.","isRequired":true,"uniqueKey":"data.items.[INDEX].executions.items.[INDEX].ai_platform","typeLabel":"string"}},"required":["id","title","execution_date","score","ai_platform"],"uniqueKey":"data.items.[INDEX].executions.items.[INDEX]","typeLabel":"object"},"description":"List of executions","isRequired":true,"uniqueKey":"data.items.[INDEX].executions","typeLabel":"object[]"},"query_group_name":{"type":"string","description":"Name of the query group","uniqueKey":"data.items.[INDEX].query_group_name","typeLabel":"string"},"num_of_queries":{"oneOf":[{"type":"number","description":"Number of queries","uniqueKey":"data.items.[INDEX].num_of_queries.oneOf.0","typeLabel":"number"},{"type":"null","description":"Number of queries","uniqueKey":"data.items.[INDEX].num_of_queries.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].num_of_queries","typeLabel":"number | null"}},"required":["query_group_id","group_type","query_group_title","created_time","keywords","website_url","run_from_location","executions"],"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"description":"List of query groups","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"version":{"type":"string","description":"API version","isRequired":true,"uniqueKey":"version","typeLabel":"string"},"env":{"type":"string","description":"Environment name","isRequired":true,"uniqueKey":"env","typeLabel":"string"}},"required":["data","version","env"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"query_group_id":123,"group_type":"\u003cstring>","created_time":"2023-11-07T05:31:56Z","keywords":"\u003cstring>","website_url":"\u003cstring>","run_from_location":"\u003cstring>","executions":[{"id":123,"title":"\u003cstring>","execution_date":"2023-12-25","score":123,"ai_platform":"\u003cstring>"}],"query_group_name":"\u003cstring>","num_of_queries":123}],"version":"\u003cstring>","env":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f77b6360-c5d8-4263-8972-8cd949a79774":{"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]}}},"servers":{"5acce9d0-04b0-4a0e-be94-016b584dfc86":{"url":"https://api.mindshare.so/customer/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyHeader","name":"X-API-Key"}],"title":"apiKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"mindshare","siteName":"Mindshare AI","title":"Get Query Groups - Mindshare AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-19T08:31:23.214Z","originalFileLocation":"api-reference/endpoint/get-customer-query-groups.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=\"Retrieve query groups associated with a customer. A query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups. This endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mindshare AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mindshare/_zIwOFSRnCXMRrAH/_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/mindshare/_zIwOFSRnCXMRrAH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mindshare/_zIwOFSRnCXMRrAH/_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/mindshare/_zIwOFSRnCXMRrAH/_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/mindshare/_zIwOFSRnCXMRrAH/_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/mindshare/_zIwOFSRnCXMRrAH/_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/mindshare/_zIwOFSRnCXMRrAH/_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/mindshare/_zIwOFSRnCXMRrAH/_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/mindshare/_zIwOFSRnCXMRrAH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Query Groups - Mindshare AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve query groups associated with a customer. A query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups. This endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mindshare AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mindshare.mintlify.app/_mintlify/api/og/v2?division=Data+Retrieval\u0026amp;title=Get+Query+Groups\u0026amp;description=Retrieve+query+groups+associated+with+a+customer.%0AA+query+group+represents+a+set+of+related+queries+for+a+specific+product+line+or+campaign.+Customers+can+have+\u0026amp;theme=a0d0527678850754c13dc2c1\u0026amp;signature=c2abbca7389eed6a6bf66d0b0fc5147ce0676aef453b6aa7e9ad66427fea5d62\">\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 Query Groups - Mindshare AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve query groups associated with a customer. A query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups. This endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mindshare.mintlify.app/_mintlify/api/og/v2?division=Data+Retrieval\u0026amp;title=Get+Query+Groups\u0026amp;description=Retrieve+query+groups+associated+with+a+customer.%0AA+query+group+represents+a+set+of+related+queries+for+a+specific+product+line+or+campaign.+Customers+can+have+\u0026amp;theme=a0d0527678850754c13dc2c1\u0026amp;signature=c2abbca7389eed6a6bf66d0b0fc5147ce0676aef453b6aa7e9ad66427fea5d62\">\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/mindshare/_zIwOFSRnCXMRrAH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mindshare AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8B5CF6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/get-customer-query-groups.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mindshare.so/#organization\",\"name\":\"Mindshare AI\",\"url\":\"https://docs.mindshare.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mindshare/rDFI1T0ZDib06cKe/logo/light1.svg?fit=max\u0026auto=format\u0026n=rDFI1T0ZDib06cKe\u0026q=85\u0026s=af7e774d5fe9f7d2d94066a2d2a6d844\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mindshare.so#website\",\"name\":\"Mindshare AI\",\"url\":\"https://docs.mindshare.so\",\"publisher\":{\"@id\":\"https://docs.mindshare.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups#webpage\",\"url\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups\",\"name\":\"Get Query Groups\",\"description\":\"Retrieve query groups associated with a customer. A query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups. This endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.\",\"dateModified\":\"2026-04-19T08:31:23.214Z\",\"isPartOf\":{\"@id\":\"https://docs.mindshare.so#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.mindshare.so/api-reference/endpoint/get-organization-customers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Data Retrieval\",\"item\":\"https://docs.mindshare.so/api-reference/endpoint/get-organization-customers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Query Groups\",\"item\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups#apireference\",\"headline\":\"Get Query Groups\",\"name\":\"Get Query Groups\",\"description\":\"Retrieve query groups associated with a customer. A query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups. This endpoint returns keywords, scan location, and a complete history of all scans with their scores and dates.\",\"url\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mindshare.so/api-reference/endpoint/get-customer-query-groups#webpage\"},\"dateModified\":\"2026-04-19T08:31:23.214Z\",\"publisher\":{\"@id\":\"https://docs.mindshare.so/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mindshare.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mindshare AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Mindshare AI","nav":{"global":null,"tabs":[{"tab":"Mindshare API","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Rate Limits","href":"/api-reference/rate-limits"},{"title":"Response Codes","href":"/api-reference/response-codes"}]},{"group":"Endpoints","pages":[{"group":"Data Retrieval","pages":[{"title":"Get Org Customers","openapi":"POST /get-organization-customers","href":"/api-reference/endpoint/get-organization-customers"},{"title":"Get Org Quota Status","openapi":"POST /get-organization-quota-status","description":"Returns the organization's query group quota, how many are currently in use, and a per-customer breakdown of active query groups.","href":"/api-reference/endpoint/get-organization-quota-status"},{"title":"Get Query Groups","openapi":"POST /get-customer-query-groups","href":"/api-reference/endpoint/get-customer-query-groups"},{"title":"Get Queries","openapi":"POST /get-queries","description":"This endpoint returns a comprehensive list of queries with complete answer analysis, including whether your customer appears in the answers, the full answer text, competitors mentioned in responses, and all sources cited in the answers.\n\nUse either queryGroupID with a date range for historical data, or executionID to get results from a specific scan.\n\nResults include executions from all supported AI platforms (e.g. ChatGPT, Google AI Overview) by default.","href":"/api-reference/endpoint/get-queries"},{"title":"Get Queries Definitions","openapi":"POST /get-queries-definitions","href":"/api-reference/endpoint/get-queries-definitions"},{"title":"Get Companies Stats","openapi":"POST /get-companies-stats","href":"/api-reference/endpoint/get-companies-stats"},{"title":"Get Domain Stats","openapi":"POST /get-domain-stats","href":"/api-reference/endpoint/get-domain-stats"},{"title":"Get Recommendations","openapi":"POST /get-recommendations","href":"/api-reference/endpoint/get-recommendations"},{"title":"Get Customer Growth Stats","openapi":"POST /get-customer-growth-stats","href":"/api-reference/endpoint/get-customer-growth-stats"},{"title":"Get Execution Status","openapi":"POST /get-execution-status","href":"/api-reference/endpoint/get-execution-status"}]},{"group":"Management","pages":[{"title":"Create Query Group","openapi":"POST /create-query-group","href":"/api-reference/endpoint/create-query-group"},{"title":"Create Query Group From Existing","openapi":"POST /create-query-group-from-existing","href":"/api-reference/endpoint/create-query-group-from-existing"},{"title":"Update Query Group Name","openapi":"POST /update-query-group-name","href":"/api-reference/endpoint/update-query-group-name"},{"title":"Update Query Group Status","openapi":"POST /update-query-group-status","href":"/api-reference/endpoint/update-query-group-status"},{"title":"Edit Queries Definitions","openapi":"POST /edit-queries-definitions","href":"/api-reference/endpoint/edit-queries-definitions"}]},{"group":"Utilities","pages":[{"title":"Generate Keywords","openapi":"POST /generate-keywords","href":"/api-reference/endpoint/generate-keywords"}]}]},{"group":"Use Cases","pages":[{"title":"Agency Dashboard","href":"/use-cases/agency-dashboard"}]}]}]},"title":"Get Query Groups - Mindshare AI","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}