Keepa API Docs
Keepa API / Getting Started / API ChangelogMarkdown

API Changelog

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: 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: new exists filter, selecting products by whether a field holds a value at all — "exists": { "brand": false } returns those with no brand.
  • Statistics Object: 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: 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: 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: 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.

1. Additions#

  • Seller Finder (/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, 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 request.

August 6, 2026#

Notifications now carry a stable identifier.

1. Additions#

  • Notification Object: 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 gains a new series selection surface and access to all three Keepa graph types.

1. Additions#

  • Graph Image API: the new types parameter selects series by csv type index, 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: 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: new legend parameter toggles the chart legend (1 = show, default).
  • Graph Image API: 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: the maximum width and height are now 1800 px.

2. Semantic & logic changes#

  • Graph Image API: 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: 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: 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: the following fields will be removed: deals.endTime, deals.startTime, deal.percentClaimed, formats, newPriceIsMAP.
  • Statistics Object: buyBoxMinOrderQuantity, buyBoxMaxOrderQuantity, and buyBoxIsPrimePantry will be removed.
  • Category Object: 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 fields will be removed. Please migrate to their replacements:

Removed fieldUse instead
variationCSVvariations
imagesCSVimages
productGroupwebsiteDisplayGroupName

2. Semantic & logic changes#

  • Product Search Request: 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:
    • 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.

February 23, 2026#

1. Field deprecations (removed from response)#

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

2. Semantic & logic changes#

Please update your logic to accommodate these new definitions:

  • Seller Object: the totalStorefrontAsins value is now calculated using Keepa’s internal database aggregation rather than the Amazon storefront.
  • Product Object (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#

4. Improvements#

  • Product Object: 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.