API changelog

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

2.10.0 (04/05/2025)

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

2.9.0 (19/04/2025)

• New generic.power metadata attribute is introduced.

2.8.0 (18/03/2025)

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

2.7.0 (24/02/2025)

• New barcodeDetails attribute is 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 is replaced with generic.colors. See Product metadata — generic for more information.

2.5.0 (28/12/2024)

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

2.4.1 (15/12/2024)

• externalIds attribute is added to Product ingredients metadada.

2.4.0 (23/11/2024)

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

2.3.0 (17/03/2024)

Added generic.volume metadata containing product volume information. See Product metadata — generic for more information.

2.2.0 (28/01/2024)

Added food.nutriScore metadata containing food Nutri-Score information. See Product metadata — food for more information.

2.1.0 (23/12/2023)

Added generic.dimensions metadata containing product and packaging dimensions information. See Product metadata — generic for more information.

2.0.0 (13/11/2023)

• Dropped support for application/xml response content type
• Removed generic.materials metadata property — replaced by Product ingredients metadata
• Removed generic.weightGrams metadata property — replaced by a new generic.weight metadata property. See Product metadata — generic for more information.

API v1 will be completely replaced by v2 starting December 11th.

1.18.0 (11/10/2023)

Added generic.ingredients metadata that holds product ingredients or materials. See Product ingredients metadata for more information.

1.17.0 (18/09/2023)

Added cholesterolMg, sodiumMg, potassiumMg, calciumMg fields to food.nutrimentsPer100Grams metadata. See Product metadata — food for more information.

1.16.0 (12/07/2023)

Added images.isCatalog field. See Products API for more information.

1.15.0 (12/07/2023)

Added relatedBrands field. See Products API for more information.

1.14.0 (21/06/2023)

Added more generic.contributors types.

1.13.0 (12/06/2023)

Added generic.contributors metadata. See Product metadata — generic for more information.

1.12.0 (30/05/2023)

Added more generic.color and generic.materials types.

1.11.0 (30/04/2023)

Added generic.materials metadata. See Product metadata — generic for more information.

1.10.0 (15/04/2023)

Added printBook.bisacCodes and musicCD.numberOfDiscs metadata. See Product metadata — printBook for more information.

1.9.0 (13/03/2023)

Added images field. See Products API for more information.

1.8.0 (27/02/2023)

Added generic.color metadata. See Product metadata — generic for more information.

1.7.0 (03/02/2023)

Added generic.manufacturerCode metadata. See Product metadata — generic for more information.

1.6.0 (19/01/2023)

Added generic.weightGrams metadata. See Product metadata — generic for more information.

1.5.0 (17/12/2022)

Added externalIds.amazonAsin metadata. See Product metadata — externalIds for more information.

1.4.0 (15/11/2022)

Added printBook.bindingType metadata. See Product metadata for more information.

1.3.1 (09/11/2022)

Bugfixes for printBook and musicCD metadata.

1.3.0 (05/11/2022)

Added food.nutrimentsPer100Grams metadata. See Product metadata — food for more information.

1.2.0 (31/10/2022)

Added printBook.publishedYear metadata. See Product metadata — printBook for more information.

1.1.0 (27/10/2022)

Added printBook.numPages and musicCD.releasedYear metadata. See Product metadata — printBook for more information.