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

# Get a specific market analysis

> Get a specific market analysis with all keywords.



## OpenAPI

````yaml https://dev-api.cattix.com/openapi.json get /api/v1/market-analysis/analyses/{analysis_id}
openapi: 3.1.0
info:
  title: CATTIX API
  description: CATTIX Backend API
  version: 0.107.0
servers:
  - url: http://localhost:8000
    description: Local
  - url: https://dev-api.cattix.com
    description: Development
  - url: https://staging-api.cattix.com
    description: Staging
  - url: https://api.cattix.com
    description: Production
security: []
paths:
  /api/v1/market-analysis/analyses/{analysis_id}:
    get:
      tags:
        - Market Analysis
      summary: Get a specific market analysis
      description: Get a specific market analysis with all keywords.
      operationId: get_market_analysis_api_v1_market_analysis_analyses__analysis_id__get
      parameters:
        - name: analysis_id
          in: path
          required: true
          schema:
            type: integer
            title: Analysis Id
        - name: include_keywords
          in: query
          required: false
          schema:
            type: boolean
            default: false
            title: Include Keywords
        - name: include_unselected_keywords
          in: query
          required: false
          schema:
            type: boolean
            default: false
            title: Include Unselected Keywords
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketAnalysisSchema'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - OAuth2PasswordBearer: []
components:
  schemas:
    MarketAnalysisSchema:
      properties:
        title:
          type: string
          title: Title
          description: Analysis title
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
          description: Summary/description of the market analysis
        do_include_assistant_knowledge_item:
          type: boolean
          title: Do Include Assistant Knowledge Item
          description: Whether to include assistant knowledge items for this analysis
          default: false
        config:
          anyOf:
            - $ref: '#/components/schemas/MarketAnalysisConfigSchema'
            - type: 'null'
          description: Analysis configuration (can be empty on Market Analysis creation)
        google_ads_customer_id:
          type: integer
          title: Google Ads Customer Id
          description: Google Ads customer ID
        id:
          type: integer
          title: Id
          description: Analysis ID
        status:
          $ref: '#/components/schemas/MarketAnalysisStatus'
          description: Analysis status (draft, completed, campaign_created)
        created_campaign_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Created Campaign Id
          description: ID of created campaign if any
        date_added:
          type: string
          format: date-time
          title: Date Added
          description: Creation timestamp
        date_updated:
          type: string
          format: date-time
          title: Date Updated
          description: Last update timestamp
        keywords:
          items:
            $ref: '#/components/schemas/MarketAnalysisKeywordSchema'
          type: array
          title: Keywords
          description: Associated keywords
      type: object
      required:
        - title
        - google_ads_customer_id
        - id
        - status
        - date_added
        - date_updated
      title: MarketAnalysisSchema
      description: Schema for a market analysis.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MarketAnalysisConfigSchema:
      properties:
        services:
          items:
            type: string
          type: array
          title: Services
          description: Service keywords
        location_ids:
          items:
            type: integer
          type: array
          title: Location Ids
          description: Location IDs
        language_id:
          type: integer
          title: Language Id
          description: Language ID
          default: 1000
        website_url:
          anyOf:
            - type: string
              maxLength: 2083
              minLength: 1
              format: uri
            - type: 'null'
          title: Website Url
          description: Website URL for the business
      type: object
      required:
        - services
        - location_ids
      title: MarketAnalysisConfigSchema
      description: Schema for market analysis configuration.
    MarketAnalysisStatus:
      type: string
      enum:
        - draft
        - completed
        - campaign_created
      title: MarketAnalysisStatus
      description: The status of market analysis.
    MarketAnalysisKeywordSchema:
      properties:
        id:
          type: integer
          title: Id
          description: Keyword ID
        keyword_text:
          type: string
          title: Keyword Text
          description: Keyword text
        is_selected:
          type: boolean
          title: Is Selected
          description: Whether keyword is selected for forecast/campaign
        avg_monthly_searches:
          type: integer
          title: Avg Monthly Searches
          description: Average monthly searches
        competition:
          type: string
          title: Competition
          description: Competition name
        competition_index:
          type: integer
          title: Competition Index
          description: Competition index
        low_bid:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Low Bid
          description: Low-bid price
        high_bid:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: High Bid
          description: High-bid price
      type: object
      required:
        - id
        - keyword_text
        - is_selected
        - avg_monthly_searches
        - competition
        - competition_index
        - low_bid
        - high_bid
      title: MarketAnalysisKeywordSchema
      description: Schema for a market analysis keyword with selection status.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: api/v1/users/authorization/token

````