Changelog

Our API loosely follows semantic versioning. Some breaking changes in metadata fields may occur in minor releases.

2.19.0 (17/02/2026)

• Added support for more colors and shades to generic.colors metadata.
• Added support for more contributor types to generic.contributors metadata.
• Added support for more battery types to electric.batteryChemistry metadata.
• Added support for apparent energy capacity to electric.batteryCapacity metadata.

2.18.0 (05/02/2026)

• New metadata attributes are introduced: electric.batteryCapacity, electric.batteryChemistry and electric.batterySize.
• printBook.bisacCodes metadata attribute is relocated to externalIds.bisacCodes.

2.17.0 (02/02/2026)

• electric.voltage attribute is extended to support input, nominal and operational voltage.

2.16.0 (20/01/2026)

• generic.ageGroups is removed in favor of generic.recommendedAge.

2.15.0 (09/01/2026)

• Added support for more colors and shades to generic.colors metadata.

2.14.0 (29/11/2025)

• generic.storageConditions metadata attribute was introduced.

2.13.0 (08/08/2025)

• generic metadata attributes were extended with ageGroups and genderFit attributes.
• media.numberOfDisks metadata attribute was migrated to generic.numberOfItems attribute.
• A new apparel.sizes metadata attribute was introduced.
• Amount objects (now named as Measurement) can now have string values.

2.12.0 (08/07/2025)

• Two new API methods for adding and revoking JWTs were added to the Account API.

2.11.0 (16/06/2025)

• fiber, totalSugars, addedSugars, saturatedFat, transFat, iron, vitaminD attributes were added to food.nutrimentsPer100Grams metadata.

2.10.0 (04/05/2025)

• generic.colors metadata attributes were extended with baseColor and shade attributes.
• New generic.ageGroups metadata attribute was introduced.

2.9.0 (19/04/2025)

• New generic.power metadata attribute was introduced.

2.8.0 (18/03/2025)

• New width and height attributes were added to Image objects. See Product API — response codes and objects for more information.

2.7.0 (24/02/2025)

• New barcodeDetails attribute was added, containing additional information about the barcode. See Product API — response codes and objects for more information.

2.6.0 (01/02/2025)

• generic.color metadata attribute was replaced with generic.colors. See Product metadata — generic for more information.

2.5.0 (28/12/2024)

• printBook.publishedYear and musicCD.releasedYear metadata attributes were replaced with media.publicationYear. See Product metadata — media for more information.

2.4.1 (15/12/2024)

• externalIds attribute was added to Product ingredients metadada.

2.4.0 (23/11/2024)

• New electric.voltage metadata attribute was introduced.Amount objects are now used extensively in metadata attributes (generic.dimensions, generic.volume, generic.weight, food.nutrimentsPer100Grams).

2.3.0 (17/03/2024)

• generic.volume metadata attribute, containing product volume information, was added. See Product metadata — generic for more information.

2.2.0 (28/01/2024)

• food.nutriScore metadata attribute, containing food Nutri-Score information, was added. See Product metadata — food for more information.

2.1.0 (23/12/2023)

• generic.dimensions metadata attribute, containing product and packaging dimensions information, was added. See Product metadata — generic for more information.

2.0.0 (13/11/2023)

• Support for application/xml response content type was dropped.
• generic.materials metadata attribute was replaced by Product ingredients metadata.
• generic.weightGrams metadata property was replaced by a new generic.weight metadata property. See Product metadata — generic for more information.
• API v1 is scheduled to be completely replaced by v2 starting December 11th 2023.

• Other API versions

  1.18.0 (11/10/2023)

  • generic.ingredients metadata attribute, containing product ingredients or materials, was introduced.

  1.17.0 (18/09/2023)

  • cholesterolMg, sodiumMg, potassiumMg, calciumMg attributes were added to food.nutrimentsPer100Grams metadata.

  1.16.0 (12/07/2023)

  • images.isCatalog attribute was added.

  1.15.0 (12/07/2023)

  • relatedBrands attribute was added.

  1.14.0 (21/06/2023)

  • More generic.contributors types were introduced.

  1.13.0 (12/06/2023)

  • generic.contributors metadata attribute was added.

  1.12.0 (30/05/2023)

  • More generic.color and generic.materials types were introduced.

  1.11.0 (30/04/2023)

  • generic.materials metadata attribute was added.

  1.10.0 (15/04/2023)

  • printBook.bisacCodes and musicCD.numberOfDiscs metadata attributes were added.

  1.9.0 (13/03/2023)

  • images attribute was added.

  1.8.0 (27/02/2023)

  • generic.color metadata attribute was added.

  1.7.0 (03/02/2023)

  • generic.manufacturerCode metadata attribute was added.

  1.6.0 (19/01/2023)

  • generic.weightGrams metadata attribute was added.

  1.5.0 (17/12/2022)

  • externalIds.amazonAsin metadata attribute was added.

  1.4.0 (15/11/2022)

  • printBook.bindingType metadata attribute was added.

  1.3.0 (05/11/2022)

  • food.nutrimentsPer100Grams metadata attribute was added.

  1.2.0 (31/10/2022)

  • printBook.publishedYear metadata attribute was added.

  1.1.0 (27/10/2022)

  • printBook.numPages and musicCD.releasedYear metadata attributes were added.