Skip to main content
POST
/
content-changes
Retrieve a list of content changes
curl --request POST \
  --url https://mm-api.merchantspring.io/content-changes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "mid": "<string>",
  "marketplaceType": "<string>",
  "marketplaceSubtype": "<string>",
  "marketplaceCountry": "<string>",
  "paginationParams": {
    "pageIndex": 0,
    "pageSize": 100,
    "sortKey": "updatedAt",
    "sortOrder": "asc"
  },
  "searchText": "<string>",
  "differentKeys": "<string>"
}
'
{
  "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
        }
      }
    }
  ]
}

Authorizations

x-api-key
string
header
required

Body

application/json

Filter and pagination criteria

mid
string
required

Store ID (merchant ID)

marketplaceType
string
required

Marketplace type (e.g. amazon, walmart)

marketplaceSubtype
string
required

Marketplace subtype (e.g. seller, vendor)

marketplaceCountry
string
required

Marketplace country code (e.g. US, GB)

paginationParams
object
required
searchText
string

Search by product identifier, title or product type

differentKeys
string

Comma-separated list of fields to filter by 'different' status (e.g. 'title,images'). Valid values: title, images, bulletPoints, description, browseNode, productType, relationships

Response

Successful operation

pageIndex
integer

Zero-based page index

pageSize
integer

Number of results per page

totalCount
integer

Total number of matching products

totalPages
integer

Total number of pages

items
object[]