Reviews Field added & Field Deprecations

New CSV Data Types: Added history types for offer counts split by fulfillment method:

• COUNT_NEW_FBA (index 34): New FBA offer count history.
• COUNT_NEW_FBM (index 35): New FBM offer count history.

Field added

• reviews

⚠️ Breaking Changes & Removals

Rental Data Removed:

• Product: Removed fields rentalDetails, rentalPrices, and rentalSellerId.
• Requests: The rental parameter in getProductRequest and getProductByCodeRequest has been disabled.
• Structs: Removed usage of RentalObject.

Scam & Add-on Attributes Removed:

• Offer: Removed isScam and isAddonItem booleans.
• Seller: Removed isScammer boolean.

🛠 API Logic

• Seller Requests: getSellerRequest no longer supports the update to force a data collection for the storefront.

new Product, Stats, and ProductFinderRequest fields

• Product: added couponHistory (int[]) to expose historical coupon values.
• ProductFinderRequest: added dealType (String[]), historicalParentASIN (String), and buyBoxIsPrimeEligible (Boolean).
• Stats: added buyBoxSavingBasisType (String) and buyBoxSavingPercentage (Integer).

Deals & Finder Filters Expansion

• Product: added deals (with DealDetails metadata).
• DealRequest: new filters incl. isPrimeExclusive, mustHaveAmazonOffer, mustNotHaveAmazonOffer, Brand Store fields, and website/sales-rank display groups.
• ProductFinderRequest: added Brand Store, audience/edition/format/author/binding/languages, and website/sales-rank display group filters.

New fields, improved response handling, and a deprecation

Key Changes

• Response handling: Added NOT_FOUND status and new statusCode field in responses.

• Data model updates:

  • Product: new bundleItems, materials (array), specialFeatures; deprecated material.
  • Deal: new parentAsin.
  • Stats: new buyBoxSavingBasis.
  • APlusModule: new imageAltText and asin.
  • VariationObject: new image.

Migration Notes

• Update enum handling to cover NOT_FOUND.
• Prefer materials over material.
• Use statusCode for better error handling.
• Integrate new fields where applicable (bundles, special features, buy box pricing, A+ content).

Seller Competitors and offerDuplicates

Added Seller fields:

• competitors
• avgBuyBoxCompetitors
• buyBoxNewOwnershipRate
• buyBoxUsedOwnershipRate

Added Offer field:

• offerDuplicates

Added dependencies in maven release pom

Bugfix

This release resolves an issue related to incorrect data types assigned to certain fields.

Expanded Product and Category Data

This release introduces several new data fields to enhance product and category information:

• Category: Added aggregated statistics like average Buy Box prices (current, 90d, 365d, deviation), average review counts/ratings, FBA/Amazon/Coupon percentages, offer counts, and seller/brand counts.
• Product:
  • Introduced structured Image[] images field with metadata (replacing deprecated imagesCSV).
  • Added websiteDisplayGroup field for product grouping.
  • Added Format[] formats field for book formats.

⚠️ Breaking Changes
The rootCategory field in ProductFinderRequest has changed type from Long to String[] to support filtering by multiple root categories. Update your code accordingly if you use this field.

⚠️ Bug
This release contains a bug that affects the parsing of product objects. Please upgrade to version 1.97 or later.

Added Deals Request Filter

Added isLowest90 filter to the Deals Request.

Added Product Finder Query Filters

Added:
New filters to the Product Finder request.

Fixed:
buyBoxUsedCondition, brandStoreName and brandStoreUrlName definitions

Expanded Product Data Fields

This release introduces enhancements to the Keepa API, focusing on enriched product data fields and expanded product finder and Deals capabilities.

Key Updates in Product Fields

• Detailed Product Attributes: New fields such as scent, shortDescription, activeIngredients, specialIngredients, itemForm, itemTypeKeyword, recommendedUsesForProduct, batteriesRequired, batteriesIncluded, style, includedComponents, material and pattern provide rich metadata.

• Brand Details: Added brandStoreName, brandStoreUrl, and brandStoreUrlName to retrieve specific brand information and links.

• Video and A+ Content Support: Added support for video metadata (videos) and A+ content (aPlus) to enhance the depth of product information.

• Other Enhancements:

  • Business-related fields such as businessDiscount, lastBusinessDiscountUpdate, and safety-related fields like safetyWarning are now included.

Enhancements in Product Finder Request

• 365-Day Metrics: New metrics (e.g., avg365_*) provide granular insights into product trends over a year, such as pricing, reviews, and sales.
• Statistical Analysis: Added fields for BuyBox standard deviations over different time frames (30, 90, 365 days).
• Flipability and Unit-Based Searches: Parameters like flipability30/90/365 and unitValue_lte/gte enable advanced product filtering.
• Product Properties: Expanded support for features like itemForm, scent, pattern, and materials.

Added Filters for Deal Requests

New filters enhance Deal Requests, including:

• Material, Type, Manufacturer, Brand, Product Group, Model
• Color, Size, Unit Type, Scent, Item Form, Pattern, Style
• ItemTypeKeyword, TargetAudienceKeyword, Edition, Format, Author, Binding
• Languages

These additions enable more precise deal searches by product attributes and metadata.

For full details, check out the commit.