# API Changelog

Source: https://env.7xmtools.com/api-docs/changelog.html

A record of additions, changes and deprecations to the Keepa API, listed newest first. Review new entries to keep your integrations running uninterrupted.

Official announcement · Latest: Oct 8, 2026

## October 8, 2026

Search Insights now split the new offers by fulfilment.

### 1. Additions

- [Search Insights Object](https://env.7xmtools.com/api-docs/search-insights-object.html#fields): new `avgOfferCountNewFBA` and `avgOfferCountNewFBM` fields, the average number of new offers per product fulfilled by Amazon and by the merchant. Both average over the same products as `avgOfferCountNew`, counting a product without offers of that kind as 0, so together they come close to `avgOfferCountNew`.

## September 3, 2026

Filtering on missing values, and whether a Buy Box price already includes import fees.

### 1. Additions

- [Product Finder](https://env.7xmtools.com/api-docs/product-finder.html#exists-filter): new `exists` filter, selecting products by whether a field holds a value at all — `"exists": { "brand": false }` returns those with no brand.
- [Statistics Object](https://env.7xmtools.com/api-docs/statistics-object.html#fields): new `buyBoxPriceIncludesImportFees` field, whether the price Amazon displays for the Buy Box offer includes the import fees deposit. Where it does, the reported `buyBoxPrice` excludes them.

## August 27, 2026

Variations now carry their parent’s descriptive text.

### 1. Additions

- [Product Object](https://env.7xmtools.com/api-docs/product-object.html#fields-variations): new `parentTitle` and `parentHighlights` fields, carrying the `title` and `itemHighlights` of the ASIN named in `parentAsin`. They are provided on variations only — a parent product references itself in `parentAsin` and so has neither — and let a variation be labelled with its parent’s wording without a second request for the parent ASIN. Both are snapshots of the parent’s current values and are **undefined** when the parent cannot be resolved, `parentHighlights` also when the parent has no item highlights.

## August 25, 2026

Offers now carry the strikethrough price Amazon shows above them.

### 1. Additions

- [Offer Object](https://env.7xmtools.com/api-docs/offer-object.html#fields): new `savingBasis` field, the offer’s strikethrough reference price, together with `savingBasisType` stating what that number is — the *typical price* (the 90-day median paid), the EU *recent lowest price* of the last 30 days, a manufacturer *list price*, or a *new price* shown against a used offer. Amazon renders all four identically, so the type is required to read the value correctly. Both fields are only present when Amazon shows a reference price for that offer.

## August 18, 2026

Product images now state what they show.

### 1. Additions

- [Product Object](https://env.7xmtools.com/api-docs/product-object.html#fields-images-categories): new `variant` field on every entry of the `images` array. It carries Amazon’s own image variant code — *MAIN* for the primary image, *PT01* – *PT08* for further catalogue images, *SWCH* for the colour or style swatch, and a long tail of others such as angle shots, ingredient and nutrition panels and interior pages — so an image can be selected by what it shows rather than by its position in the array.

## August 9, 2026

A new endpoint joins the API: the [Seller Finder](https://env.7xmtools.com/api-docs/seller-finder.html).

### 1. Additions

- [Seller Finder](https://env.7xmtools.com/api-docs/seller-finder.html) (`/sellerquery`): queries the seller database with complex filter criteria — name and business details, rating history, fulfilment activity, storefront size, Buy Box performance and catalogue profile — and returns a `sellerIdList`. It uses the same request grammar as the [Product Finder](https://env.7xmtools.com/api-docs/product-finder.html), including `page` / `perPage`, `sort` and the `_gte` / `_lte` range syntax, and adds a free-text `search` filter across seller name, business name, address and the identifier fields. Token cost: 10 tokens + 1 per 100 returned seller IDs. The response carries seller IDs only — resolve them through the [Seller Information](https://env.7xmtools.com/api-docs/seller.html) request.

## August 6, 2026

Notifications now carry a stable identifier.

### 1. Additions

- [Notification Object](https://env.7xmtools.com/api-docs/notification-object.html): new `notificationId` field, a unique identifier for the notification. It is present on notifications delivered by webhook and by the *Get Notifications* call, and lets you refer to one specific notification rather than matching on `asin`, `createDate`, `csvType` and `trackingNotificationCause` together.

## July 28, 2026

The [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.html) gains a new series selection surface and access to all three Keepa graph types.

### 1. Additions

- [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.html#param-types): the new `types` parameter selects series by [csv type index](https://env.7xmtools.com/api-docs/product-object.html#csv-array), each optionally with its own colour — for example `&types=11:8888dd,12,34`. It reaches every drawable csv type, including the offer counts, rating and review count that were not previously selectable.
- [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.html#rank-graphs): the **Category Sales Ranks & Monthly Sales** graph can now be rendered, through `subranks`, `cRanks`, `monthlysold` and `cMonthlysold`. Each category is scaled on its own axis so the shapes stay comparable.
- [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.html): new `legend` parameter toggles the chart legend (`1` = show, default).
- [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.html): new `lw` parameter sets the series line width, from `0.5` to `3.0` (default `1.5`). It applies to all three graph types and scales each series proportionally, so their relative thicknesses are preserved.
- [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.html): the maximum `width` and `height` are now **1800** px.

### 2. Semantic & logic changes

- [Graph Image API](https://env.7xmtools.com/api-docs/graph-image.html#series-selection): Keepa offers three graph types — Price history, Category Sales Ranks & Monthly Sales, and Offer Counts and Ratings. Each has its own axes and value space, so a single image can only ever contain series from **one** of them. `types` and the sales rank parameters are mutually exclusive; a request naming both returns the bad-request image.
- [Browsing Deals](https://env.7xmtools.com/api-docs/deals.html): `priceTypes` now rejects price types that carry no deal data. Such a query previously validated and then always returned an empty result. The accepted values are listed on the Browsing Deals page.
- [Best Sellers](https://env.7xmtools.com/api-docs/best-sellers.html): requests for the current calendar month, or for an out-of-range `month`, are now rejected instead of silently returning the current-rank list.

## April 20, 2026

Please prepare for the following changes scheduled for April.

### 1. Removals & replacements

- [Product Object](https://env.7xmtools.com/api-docs/product-object.html): the following fields will be removed: `deals.endTime`, `deals.startTime`, `deal.percentClaimed`, `formats`, `newPriceIsMAP`.
- [Statistics Object](https://env.7xmtools.com/api-docs/statistics-object.html): `buyBoxMinOrderQuantity`, `buyBoxMaxOrderQuantity`, and `buyBoxIsPrimePantry` will be removed.
- [Category Object](https://env.7xmtools.com/api-docs/category-object.html): the `contextFreeName` field and promotional categories will no longer be provided.
- **Digital products:** the API will no longer provide any new data for digital products. Historical data will still be available.

#### Legacy field migration

The following legacy [Product Object](https://env.7xmtools.com/api-docs/product-object.html) fields will be removed. Please migrate to their replacements:

| Removed field | Use instead |
| --- | --- |
| `variationCSV` | `variations` |
| `imagesCSV` | `images` |
| `productGroup` | `websiteDisplayGroupName` |

### 2. Semantic & logic changes

- [Product Search Request](https://env.7xmtools.com/api-docs/product-search.html): the `page` parameter will be removed. To compensate, the result count per request will increase from 10 to 20 (token cost remains unchanged).
- [Statistics Object](https://env.7xmtools.com/api-docs/statistics-object.html):
  - The fields `buyBoxSavingBasis`, `buyBoxSavingBasisType`, and `buyBoxSavingPercentage` will require the `offers` parameter to be updated.
  - The `buyBoxAvailabilityMessage` values will change from natural language (e.g., `"In Stock"`) to one of three values: `IN_STOCK`, `BACKORDER_NO_ETA`, `BACKORDER_WITH_ETA`.

> **Note:** The removal of the `page` parameter does **not** affect the [Product Finder API](https://env.7xmtools.com/api-docs/product-finder.html).

## February 23, 2026

### 1. Field deprecations (removed from response)

The following fields have been removed to streamline the data structure:

- [Product Object](https://env.7xmtools.com/api-docs/product-object.html): `rentalDetails`, `rentalSellerId`, `rentalPrices`, and the `RENT` price history.
- [Statistics Object](https://env.7xmtools.com/api-docs/statistics-object.html): `isAddonItem`.
- [Offer Object](https://env.7xmtools.com/api-docs/offer-object.html): `isScam`.
- [Seller Object](https://env.7xmtools.com/api-docs/seller-object.html): `feedback`, `isScammer`.
- [Seller Lookup Request](https://env.7xmtools.com/api-docs/seller.html): the `update` parameter has been removed. Storefront data is now automatically populated via Keepa’s database.

### 2. Semantic & logic changes

Please update your logic to accommodate these new definitions:

- [Seller Object](https://env.7xmtools.com/api-docs/seller-object.html): the `totalStorefrontAsins` value is now calculated using Keepa’s internal database aggregation rather than the Amazon storefront.
- [Product Object](https://env.7xmtools.com/api-docs/product-object.html) (`csv` field) — **price definition update:** for the `NEW`, `USED`, `COLLECTIBLE`, and `REFURBISHED` time series, the pricing definition has changed:
  - **Historical data:** entries dated *before* February 23, 2026, reflect the **lowest listing price**.
  - **New data:** entries dated *on or after* February 23, 2026, reflect the **lowest landing price** (listing price + shipping).

### 3. Additions

- [Product Object](https://env.7xmtools.com/api-docs/product-object.html): added `COUNT_NEW_FBA` and `COUNT_NEW_FBM` histories to the `csv` field.
- [Statistics Object](https://env.7xmtools.com/api-docs/statistics-object.html): added `buyBoxShippingTime`.

### 4. Improvements

- [Product Object](https://env.7xmtools.com/api-docs/product-object.html): the `NEW_FBA` and `NEW_FBM_SHIPPING` price types are now updated more frequently.

## Questions & Support

If you have any questions regarding these updates, please contact support at [info@keepa.com](mailto:info@keepa.com).