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

# Compare products by product identifiers.

> Compare products by product identifiers.

**Authentication:** Public storefront request; controller docs mention Authorization header.

**Feature area:** Product discovery

**Implementation source:** `src/api/store/controllers/ProductController.ts`

**Request example provenance:** The source annotation calls these request parameters but the implementation binds query params; use query string in the request example.

**Response example provenance:** The source annotation calls these request parameters but the implementation binds query params; use query string in the request example.

> Example is based on the linked repository source. Replace example identifiers and credentials with values from your tenant.



## OpenAPI

````yaml /StoreAPI.json get /api/product-store/product-compare
openapi: 3.0.3
info:
  title: SpurtCommerce Store API
  version: 6.0.0
  description: >-
    Store API reference generated from the public SpurtCommerce repository
    (master, package version 6.0.0). Route inventory, controller annotations,
    request examples and response examples were used where available. Examples
    that are not explicitly defined by source annotations are marked
    illustrative in the operation description. This specification excludes Admin
    APIs.
  license:
    name: MIT
    url: https://github.com/spurtcommerce/spurtcommerce/blob/master/LICENSE
servers:
  - url: https://api.example.com
    description: Replace with your SpurtCommerce API host. Paths include the /api prefix.
security: []
tags:
  - name: Store
    description: Store API endpoint reference, organized by functional topic.
  - name: Cart
    description: >-
      Retrieve, create, update, and clear the authenticated customer shopping
      cart.
    x-parent: Store
    x-displayName: Cart
  - name: Customer address
    description: >-
      Create, retrieve, and manage customer addresses and live-address settings
      used during checkout.
    x-parent: Store
    x-displayName: Customer address
  - name: Customer profile
    description: >-
      Retrieve and update the signed-in customer profile and read customer
      permission modules and assignments.
    x-parent: Store
    x-displayName: Customer profile
  - name: Authentication
    description: >-
      Register customers, send and verify OTPs, sign in, sign out, and
      authenticate through supported OAuth providers.
    x-parent: Store
    x-displayName: Authentication
  - name: Wishlist
    description: >-
      Add products to the customer wishlist, list saved items, and remove
      wishlist entries.
    x-parent: Store
    x-displayName: Wishlist
  - name: Product discovery
    description: >-
      Discover products and categories, retrieve product details, compare
      products, and inspect filters, attributes, and variants.
    x-parent: Store
    x-displayName: Product discovery
  - name: Orders
    description: >-
      Retrieve order details and payment status, request cancellations, track
      shipments, download invoices, and retry payments.
    x-parent: Store
    x-displayName: Orders
  - name: Store content
    description: >-
      Retrieve storefront settings, categories, languages, zones, payment
      methods, CMS pages, banners, widgets, and contact information.
    x-parent: Store
    x-displayName: Store content
  - name: Payments
    description: >-
      Start supported Store payment flows for existing orders through PayPal,
      Razorpay, and Stripe.
    x-parent: Store
    x-displayName: Payments
  - name: Ratings and reviews
    description: >-
      Retrieve product rating counts, rating distributions, and customer reviews
      for product SKUs.
    x-parent: Store
    x-displayName: Ratings and reviews
  - name: Products
    x-parent: Product discovery
    description: Browse product listings and retrieve product details.
  - name: Categories
    x-parent: Product discovery
    description: Browse storefront product categories and category filters.
  - name: Product comparison
    x-parent: Product discovery
    description: Compare products and retrieve related product suggestions.
  - name: Attributes and variants
    x-parent: Product discovery
    description: Retrieve product attributes and variant options.
  - name: Product ratings and reviews
    x-parent: Product discovery
    description: Retrieve product ratings, statistics and customer reviews.
  - name: Customer login and sessions
    x-parent: Authentication
    description: Register, authenticate and sign out customer accounts.
  - name: OTP and verification
    x-parent: Authentication
    description: Send and verify one-time passwords for customer authentication.
  - name: OAuth authentication
    x-parent: Authentication
    description: Authenticate customers through supported OAuth providers.
  - name: Customer permissions
    x-parent: Customer profile
    description: Retrieve customer permission modules and assignments.
  - name: Address book
    x-parent: Customer address
    description: Manage customer delivery and billing addresses.
  - name: Cart items
    x-parent: Cart
    description: Retrieve, create and remove shopping cart items.
  - name: Order details and tracking
    x-parent: Orders
    description: Retrieve order details, tracking and payment status.
  - name: Order cancellation
    x-parent: Orders
    description: Retrieve cancellation reasons and submit cancellation requests.
  - name: Order payments
    x-parent: Orders
    description: Retry order payments and retrieve payment status.
  - name: Payment gateways
    x-parent: Payments
    description: Start Store payment flows for supported payment gateways.
  - name: Store configuration
    x-parent: Store content
    description: Retrieve storefront settings, payment methods and configuration.
  - name: Navigation and widgets
    x-parent: Store content
    description: Retrieve storefront banners, widgets and navigation data.
  - name: Localization
    x-parent: Store content
    description: Retrieve available languages, zones and localization options.
  - name: Contact and store information
    x-parent: Store content
    description: Retrieve store contact information and public store metadata.
  - name: Store pages
    x-parent: Store content
    description: Retrieve published storefront content pages.
paths:
  /api/product-store/product-compare:
    get:
      tags:
        - Product comparison
      summary: Compare products by product identifiers.
      description: >-
        Compare products by product identifiers.


        **Authentication:** Public storefront request; controller docs mention
        Authorization header.


        **Feature area:** Product discovery


        **Implementation source:**
        `src/api/store/controllers/ProductController.ts`


        **Request example provenance:** The source annotation calls these
        request parameters but the implementation binds query params; use query
        string in the request example.


        **Response example provenance:** The source annotation calls these
        request parameters but the implementation binds query params; use query
        string in the request example.


        > Example is based on the linked repository source. Replace example
        identifiers and credentials with values from your tenant.
      operationId: getApiProductStoreProductCompare
      parameters:
        - name: productId
          in: query
          required: false
          schema:
            type: string
          example: 1,2
          description: Query parameter productId.
        - name: data
          in: query
          required: false
          schema:
            type: string
          example: compare
          description: Query parameter data.
      responses:
        '200':
          description: >-
            Successful response. The source annotation calls these request
            parameters but the implementation binds query params; use query
            string in the request example.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  data:
                    type: object
                    properties:
                      createdBy:
                        type: string
                      productId:
                        type: integer
                    additionalProperties: true
                additionalProperties: true
              examples:
                success:
                  summary: Sample success response
                  value:
                    message: Successfully Product Compared
                    status: '1'
                    data:
                      createdBy: ''
                      productId: 1
      externalDocs:
        description: Open implementation source in GitHub
        url: >-
          https://github.com/spurtcommerce/spurtcommerce/blob/master/src/api/store/controllers/ProductController.ts
      x-codeSamples:
        - lang: HTTP
          label: HTTP
          source: >
            GET /api/product-store/product-compare?productId=1%2C2&data=compare
            HTTP/1.1

            Host: <API_HOST>

            Accept: application/json
        - lang: bash
          label: cURL
          source: |-
            curl --request GET \
              'https://<API_HOST>/api/product-store/product-compare?productId=1%2C2&data=compare' \
              --header 'Accept: application/json'
        - lang: JavaScript
          label: JavaScript (fetch)
          source: >-
            const API_BASE_URL = 'https://<API_HOST>';

            const url = new URL("/api/product-store/product-compare",
            API_BASE_URL);

            const query = {
              "productId": "1,2",
              "data": "compare"
            };

            for (const [key, value] of Object.entries(query)) {
              url.searchParams.set(key, String(value));
            }

            const headers = {
              "Accept": "application/json"
            };

            const response = await fetch(url, { method: "GET", headers });

            const result = await response.json();

            console.log(response.status, result);
        - lang: JavaScript
          label: Node.js (Axios)
          source: >-
            import axios from 'axios';

            const API_BASE_URL = 'https://<API_HOST>';

            const url = `${API_BASE_URL}/api/product-store/product-compare`;

            const API_BASE_URL = 'https://<API_HOST>';

            const url = `${API_BASE_URL}/api/product-store/product-compare`;

            const headers = {
              "Accept": "application/json"
            };

            const params = {
              "productId": "1,2",
              "data": "compare"
            };

            const response = await axios.request({ method: "GET", url, headers,
            params });

            console.log(response.status, response.data);
        - lang: Python
          label: Python (requests)
          source: >-
            import requests

            url = 'https://<API_HOST>/api/product-store/product-compare'

            headers = {'Accept': 'application/json'}

            params = {'productId': '1,2', 'data': 'compare'}

            response = requests.request('GET', url, headers=headers,
            params=params)

            print(response.status_code)

            print(response.json())

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.