> ## 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 a list of content changes

> Retrieve a paginated list of product content changes for a given store. Returns one record per product with per-field change status, original value, benchmark value and last-changed timestamp. Page size is capped at 500 items per request. Uses zero-based page indexing (pageIndex starts at 0).



## OpenAPI

````yaml /api-reference/openapi.json post /content-changes
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: channel
    x-group: Channel
  - name: content-change
    x-group: Content Change
  - name: custom-group
    x-group: Custom Group
  - name: order
    x-group: Order
  - name: report
    x-group: Report
  - name: tag
    x-group: Tag
  - name: profitability
    x-group: Profitability
paths:
  /content-changes:
    post:
      tags:
        - content-change
      summary: Retrieve a list of content changes
      description: >-
        Retrieve a paginated list of product content changes for a given store.
        Returns one record per product with per-field change status, original
        value, benchmark value and last-changed timestamp. Page size is capped
        at 500 items per request. Uses zero-based page indexing (pageIndex
        starts at 0).
      operationId: getContentChanges
      requestBody:
        description: Filter and pagination criteria
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetContentChangesRequest'
        required: true
      responses:
        '200':
          description: Successful operation
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetContentChangesResponse'
        '400':
          description: Invalid input
          content: {}
      security:
        - api_key: []
components:
  schemas:
    GetContentChangesRequest:
      type: object
      required:
        - mid
        - marketplaceType
        - marketplaceSubtype
        - marketplaceCountry
        - paginationParams
      properties:
        mid:
          type: string
          description: Store ID (merchant ID)
        marketplaceType:
          type: string
          description: Marketplace type (e.g. amazon, walmart)
        marketplaceSubtype:
          type: string
          description: Marketplace subtype (e.g. seller, vendor)
        marketplaceCountry:
          type: string
          description: Marketplace country code (e.g. US, GB)
        searchText:
          type: string
          description: Search by product identifier, title or product type
        differentKeys:
          type: string
          description: >-
            Comma-separated list of fields to filter by 'different' status (e.g.
            'title,images'). Valid values: title, images, bulletPoints,
            description, browseNode, productType, relationships
        paginationParams:
          type: object
          properties:
            pageIndex:
              type: integer
              description: Zero-based page index
              default: 0
            pageSize:
              type: integer
              description: Number of results per page (default 100, max 500)
              default: 100
              maximum: 500
            sortKey:
              type: string
              description: Field to sort by
              default: updatedAt
            sortOrder:
              type: string
              enum:
                - asc
                - desc
              description: Sort direction
              default: asc
    GetContentChangesResponse:
      type: object
      properties:
        pageIndex:
          type: integer
          description: Zero-based page index
        pageSize:
          type: integer
          description: Number of results per page
        totalCount:
          type: integer
          description: Total number of matching products
        totalPages:
          type: integer
          description: Total number of pages
        items:
          type: array
          items:
            $ref: '#/components/schemas/PublicContentChange'
      example:
        pageIndex: 0
        pageSize: 100
        totalCount: 250
        totalPages: 3
        items:
          - productIdentifier: B08N5WRWNW
            titleText: Example Product Title
            marketplace: amazon
            marketplaceSubtype: amazon
            country: US
            storeId: A1234567890ABC
            link: https://www.amazon.com/dp/B08N5WRWNW
            salesRank: 1234
            updatedAt: '2026-05-19T10:30:00.000Z'
            fields:
              title:
                status: different
                original: Current Product Title
                benchmark: Example Product Title
                lastDifferentAt: '2026-05-19T08:15:00.000Z'
              images:
                status: same
                original:
                  - https://m.media-amazon.com/images/I/image1.jpg
                  - https://m.media-amazon.com/images/I/image2.jpg
                benchmark:
                  - https://m.media-amazon.com/images/I/image1.jpg
                  - https://m.media-amazon.com/images/I/image2.jpg
                lastDifferentAt: null
    PublicContentChange:
      type: object
      properties:
        productIdentifier:
          type: string
          description: Product identifier (e.g. ASIN)
        titleText:
          type: string
          nullable: true
          description: Product title (benchmark value)
        marketplace:
          type: string
          description: Marketplace type
        marketplaceSubtype:
          type: string
          description: Marketplace subtype
        country:
          type: string
          description: Marketplace country code
        storeId:
          type: string
          description: Store ID
        link:
          type: string
          description: Link to product on marketplace
        salesRank:
          type: integer
          nullable: true
          description: Product sales rank
        updatedAt:
          type: string
          format: date-time
          description: Timestamp of last content change check
        fields:
          type: object
          description: >-
            Per-field change information. Only fields that have been tracked are
            present.
          properties:
            title:
              $ref: '#/components/schemas/PublicContentField'
            images:
              $ref: '#/components/schemas/PublicContentField'
            bulletPoints:
              $ref: '#/components/schemas/PublicContentField'
            description:
              $ref: '#/components/schemas/PublicContentField'
            browseNode:
              $ref: '#/components/schemas/PublicContentField'
            productType:
              $ref: '#/components/schemas/PublicContentField'
            relationships:
              $ref: '#/components/schemas/PublicContentField'
    PublicContentField:
      type: object
      properties:
        status:
          type: string
          enum:
            - same
            - different
          description: Whether the current value differs from the benchmark
        original:
          description: >-
            Current value on the marketplace (string, array of strings, or
            relationships object)
        benchmark:
          description: User-accepted baseline value
        lastDifferentAt:
          type: string
          format: date-time
          nullable: true
          description: Timestamp when this field was last observed as different
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header

````