API changelog

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

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.