> ## 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 Recommendations

> Retrieve weekly strategic recommendations for improving brand visibility.

Our system provides data-driven recommendations that help you increase your presence in AI-generated responses. Each recommendation includes:

Why it's relevant, platform where the recommendation should be executed (Reddit, blog, YouTube, etc.), references to third-party sources currently influencing AI engines, and a direct action URL when applicable.

Note: Google AI Overview is not yet supported here — at the moment all recommendations are generated based on ChatGPT visibility data only.

<Accordion title="AI Platforms">
  Google AI Overview is not yet supported by this endpoint. At the moment all recommendations are generated based on ChatGPT visibility data only. Support for additional AI platforms may be added in the future.
</Accordion>


## OpenAPI

````yaml POST /get-recommendations
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-recommendations:
    post:
      description: >-
        Retrieve weekly strategic recommendations for improving brand
        visibility.


        Our system provides data-driven recommendations that help you increase
        your presence in AI-generated responses. Each recommendation includes:


        Why it's relevant, platform where the recommendation should be executed
        (Reddit, blog, YouTube, etc.), references to third-party sources
        currently influencing AI engines, and a direct action URL when
        applicable.


        Note: Google AI Overview is not yet supported here — at the moment all
        recommendations are generated based on ChatGPT visibility data only.
      requestBody:
        description: Customer ID
        content:
          application/json:
            schema:
              type: object
              properties:
                customerID:
                  type: number
                  description: The ID of the customer
              required:
                - customerID
        required: true
      responses:
        '200':
          description: List of recommendations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecommendationsResponse'
components:
  schemas:
    RecommendationsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Recommendation'
          description: List of recommendations
        version:
          type: string
          description: API version
        env:
          type: string
          description: Environment name
      required:
        - data
        - version
        - env
    Recommendation:
      type: object
      properties:
        id:
          type: number
          description: Recommendation ID
        title:
          type: string
          description: Title of the recommendation
        task:
          type: string
          description: Task description
        data_points:
          type: string
          description: Data points supporting the recommendation
        why_important:
          type: string
          description: Why this recommendation is important
        platform:
          type: string
          description: Platform where the recommendation applies
        status:
          type: string
          description: Status of the recommendation
        date:
          type: string
          format: date
          description: Date of the recommendation
        query_group_id:
          type: number
          description: ID of the query group
        take_action_url:
          type: string
          format: uri
          nullable: true
          description: >-
            A direct URL where the user should take action. Present when the
            recommendation involves engaging with a specific external resource
            (e.g. a Reddit thread to comment on). Null when the recommendation
            is a general action without a single target URL.
        references:
          type: array
          items:
            $ref: '#/components/schemas/RecommendationReference'
          description: >-
            A list of existing third-party sources in the customer's niche that
            are currently influencing AI engines. Provided as context and
            inspiration — they show what content is already being cited by AI in
            the customer's space. Returns empty array when no references exist.
      required:
        - id
        - title
        - task
        - data_points
        - why_important
        - platform
        - status
        - date
        - query_group_id
        - take_action_url
        - references
    RecommendationReference:
      type: object
      properties:
        source_id:
          type: number
          description: Internal identifier of the source
        source_url:
          type: string
          format: uri
          description: The URL of the external source
      required:
        - source_id
        - source_url
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````