API changelog

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

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 attribute 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.

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.