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

# Retrieve multi-channel advertising product performance

> Returns paginated advertising product (ASIN) performance across up to 5 channels for the selected date range, optionally filtered to specific products. Values are currency-adjusted based on each store's country and the requested currency. Supports sorting by any response column and zero-based page indexing.



## OpenAPI

````yaml /api-reference/openapi.json get /advertising/products
openapi: 3.0.1
info:
  title: MerchantSpring Public API
  version: 1.0.0
servers:
  - url: https://mm-api.merchantspring.io
    description: Production
  - url: https://mm-api-staging.merchantspring.io
    description: Staging
security: []
tags:
  - name: advertising
    x-group: Advertising
  - name: channel
    x-group: Channel
  - name: content-change
    x-group: Content Change
  - name: custom-group
    x-group: Custom Group
  - name: order
    x-group: Order
  - name: product
    x-group: Product
  - name: report
    x-group: Report
  - name: vendor
    x-group: Vendor
  - name: tag
    x-group: Tag
  - name: profitability
    x-group: Profitability
  - name: targets
    x-group: Targets
paths:
  /advertising/products:
    get:
      tags:
        - advertising
      summary: Retrieve multi-channel advertising product performance
      description: >-
        Returns paginated advertising product (ASIN) performance across up to 5
        channels for the selected date range, optionally filtered to specific
        products. Values are currency-adjusted based on each store's country and
        the requested currency. Supports sorting by any response column and
        zero-based page indexing.
      operationId: getAdvertisingProducts
      parameters:
        - name: channelId
          in: query
          description: Channel ID. Repeat the parameter for multiple channels (max 5).
          required: true
          schema:
            type: array
            items:
              type: string
        - name: productSku
          in: query
          description: >-
            Filter to the given product(s) by their normalised product
            identifier — an ASIN on Amazon, or the equivalent product identifier
            the channel's platform uses. Repeatable (max 10).
          required: false
          schema:
            type: array
            items:
              type: string
        - name: fromDate
          in: query
          description: Start of date range as unix epoch seconds. Defaults to 30 days ago.
          required: false
          schema:
            type: integer
        - name: toDate
          in: query
          description: >-
            End of date range as unix epoch seconds. Defaults to now. The range
            must not exceed 6 months.
          required: false
          schema:
            type: integer
        - name: currency
          in: query
          description: 3-letter ISO currency code (default USD).
          required: false
          schema:
            type: string
        - name: sortKey
          in: query
          description: >-
            Response column to sort by, e.g. product_sku, cost, impressions,
            clicks, acos, roas (default product_sku).
          required: false
          schema:
            type: string
        - name: sortOrder
          in: query
          description: Sort direction (default desc).
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
        - name: pageIndex
          in: query
          description: Zero-based page index (default 0).
          required: false
          schema:
            type: integer
        - name: pageSize
          in: query
          description: Number of products per page, max 100 (default 10).
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: Successful operation
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAdvertisingProductsResponse'
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                tooManyProductSkus:
                  summary: More than 10 productSku values supplied
                  value:
                    status: error
                    error: a maximum of 10 productSku values is allowed
                tooManyChannelIds:
                  summary: More than 5 channelId values supplied
                  value:
                    status: error
                    error: a maximum of 5 channelId values is allowed
                dateRangeTooLong:
                  summary: Window exceeds the 6-month maximum
                  value:
                    status: error
                    error: Date range must not exceed 6 months
      security:
        - api_key: []
components:
  schemas:
    GetAdvertisingProductsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              channel_id:
                type: string
              product_sku:
                type: string
                description: >-
                  Normalised product identifier — an ASIN on Amazon, or the
                  equivalent product identifier the channel's platform uses.
              impressions:
                type: number
              clicks:
                type: number
              cost:
                type: number
              attributed_sales:
                type: number
              attributed_sales_same_sku:
                type: number
              attributed_conversions:
                type: number
              attributed_conversions_same_sku:
                type: number
              attributed_units_ordered:
                type: number
              attributed_units_ordered_same_sku:
                type: number
              acos:
                type: number
              click_through_rate:
                type: number
              cost_per_click:
                type: number
              conversion_rate:
                type: number
              roas:
                type: number
              product_title:
                type: string
                nullable: true
              image_url:
                type: string
                nullable: true
              link_url:
                type: string
                nullable: true
        pagination:
          type: object
          properties:
            pageIndex:
              type: integer
            pageSize:
              type: integer
            count:
              type: integer
        meta:
          type: object
          properties:
            currency:
              type: string
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - error
        error:
          type: string
          description: >-
            Human-readable message. Validation failures list every failing rule,
            comma-separated.
      example:
        status: error
        error: Invalid request parameters
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header

````