List Listing Changes for a Seller
get_seller_listing_changesMonitor Amazon listing changes—price, content, or image edits—for a seller account. Filter by ASIN, brand, change type, or date range to see what changed and its ranking/conversion impact.
Instructions
Use this when the user asks what changed on their Amazon listings — price, content (title/bullets/description), or image edits — for a seller account. Requires a sellerId + marketplace (use list_seller_profiles to discover them). Filter by types, asin/parent ASIN, brand, search, and a startDate/endDate range; sort with sortBy/sortOrder. Set includeCorrelations: true to attach the ranking/conversion impact per change. Returns a paginated list where each item has asin, title, imageUrl, date, type, contentType, description, previousValue, newValue, and (optionally) correlation, plus pagination metadata (currentPage, pageSize, total, lastPage, hasNext, hasPrev).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sellerId": "<sellerId>",
"marketplace": "<marketplace>"
},
"name": "get_seller_listing_changes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asin | No | Filter to an exact ASIN or parent ASIN. | |
| brand | No | Case-insensitive partial match on brand name. | |
| types | No | Filter to specific change types. Omit for all. Any of "Price", "Content", "Image". | |
| search | No | Case-insensitive partial match on product title or brand. | |
| sortBy | No | Sort field. "date" (default) or "type". | |
| endDate | No | ISO-8601 date/timestamp; return only changes detected on or before this time. | |
| pageSize | No | Items per page (max 50). Defaults to 20. | |
| sellerId | Yes | Amazon seller account ID. Get it from `list_seller_profiles`, or find it on the Connections page at https://2.datadive.tools. | |
| sortOrder | No | Sort direction. "DESC" (default) or "ASC". | |
| startDate | No | ISO-8601 date/timestamp; return only changes detected on or after this time. | |
| currentPage | No | Page number, 1-indexed. Defaults to 1. | |
| marketplace | Yes | Amazon marketplace code, e.g. "com" for amazon.com or "co.uk" for amazon.co.uk. | |
| includeCorrelations | No | When true, include the ranking/conversion `correlation` object per change (CVR and search-term movement before vs after). Defaults to false. |