> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindshare.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Queries

> 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.

Use either queryGroupID with a date range for historical data, or executionID to get results from a specific scan.

Results include executions from all supported AI platforms (e.g. ChatGPT, Google AI Overview) by default.

<Accordion title="AI Platforms (`aiPlatform`)">
  Results include executions from all supported AI platforms by default. Each item in the response includes an `ai_platform` field so you can distinguish rows per platform.

  Use the optional `aiPlatform` request parameter to filter the response to a single platform. Current values:

  * `chatgpt` — ChatGPT
  * `aioverview` — Google AI Overview

  Additional platforms may be added in the future.

  When `executionID` is provided, `aiPlatform` is not needed because an execution already belongs to a single platform.
</Accordion>


## OpenAPI

````yaml POST /get-queries
openapi: 3.1.0
info:
  title: Mindshare API
  description: >-
    The Mindshare API provides comprehensive access to brand visibility
    analytics, customer intelligence, and growth tracking. Use this API to
    retrieve customer data, query groups, execution results, domain insights,
    and actionable recommendations for improving your brand's AI visibility.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.mindshare.so/customer/v1
security:
  - apiKeyHeader: []
paths:
  /get-queries:
    post:
      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.


        Use either queryGroupID with a date range for historical data, or
        executionID to get results from a specific scan.


        Results include executions from all supported AI platforms (e.g.
        ChatGPT, Google AI Overview) by default.
      requestBody:
        description: Get queries parameters
        content:
          application/json:
            schema:
              type: object
              properties:
                customerID:
                  type: number
                  description: The ID of the customer
                queryGroupID:
                  type: number
                  description: The ID of the query group
                startDate:
                  type: string
                  format: date
                  description: Start date in yyyy-mm-dd format
                endDate:
                  type: string
                  format: date
                  description: End date in yyyy-mm-dd format
                executionID:
                  type: number
                  description: The ID of the execution
                aiPlatform:
                  type: string
                  description: >-
                    Optional. Filter results to a single AI platform. Current
                    values: 'chatgpt' (ChatGPT), 'aioverview' (Google AI
                    Overview). Additional platforms may be added in the future.
                    If omitted, results from all platforms are returned. Not
                    needed when 'executionID' is provided, since an execution
                    already belongs to a single platform.
              required:
                - customerID
        required: true
      responses:
        '200':
          description: List of queries
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueriesResponse'
components:
  schemas:
    QueriesResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Query'
          description: List of queries
        version:
          type: string
          description: API version
        env:
          type: string
          description: Environment name
      required:
        - data
        - version
        - env
    Query:
      type: object
      properties:
        resources_data_path:
          type: string
          format: uri
          description: URL to resources data
        date:
          type: string
          format: date-time
          description: Query execution date
        is_product_in_results:
          type: number
          description: Whether product is in results (0 or 1)
        competitors_data_path:
          type: string
          format: uri
          description: >-
            URL to competitors full data. The main customer can appear in this
            list.
        query:
          type: string
          description: The query text
        query_id:
          type: number
          description: Query ID
        execution_id:
          type: number
          description: Execution ID
        ai_platform:
          type: string
          description: >-
            AI platform this query result came from. Current values: 'chatgpt'
            (ChatGPT), 'aioverview' (Google AI Overview). Additional platforms
            may be added in the future.
        query_results_path:
          type: string
          format: uri
          description: URL to query results text
      required:
        - resources_data_path
        - date
        - is_product_in_results
        - competitors_data_path
        - query
        - query_id
        - execution_id
        - ai_platform
        - query_results_path
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````