API/OpenBeautyFacts

<Back to API(Required reading)

The new version of the documentation is available here:

• Documentation as HTML on Open Food Facts' servers
• Documentation on Postman (might be slow)

Open Beauty Facts experimental and specific APIs

Product in Open Beauty Facts

• https://ssl-api.openbeautyfacts.org/api/v0/product/3560070791460.json

Ingredients

Very experimental. Do not rely on this for allergen or ingredient parsing yet.

List of ingredients detected by the current experimental parser

• https://world.openbeautyfacts.org/ingredients.json
• https://world.openbeautyfacts.org/ingredients.xml

Products where the current experimental parser could not detect aluminium salts

• https://world.openbeautyfacts.org/ingredient/-aluminum-salts.json
• https://world.openbeautyfacts.org/ingredient/-aluminum-salts.xml

Products where the current experimental parser could detect aluminium salts

• https://world.openbeautyfacts.org/ingredient/aluminum-salts.json
• https://world.openbeautyfacts.org/ingredient/aluminum-salts.xml

Periods after Opening

Periods after opening taxonomy

List of periods after opening

• https://world.openbeautyfacts.org/periods-after-opening.json
• https://world.openbeautyfacts.org/periods-after-opening.xml

List of products with a given period after opening

• https://world.openbeautyfacts.org/period-after-opening/12-months.json
• https://world.openbeautyfacts.org/period-after-opening/12-months.xml

Values

• https://world.openbeautyfacts.org/api/v2/product/3560070791460.json
• https://en.wiki.openbeautyfacts.org/Global_periods_after_opening_taxonomy

"periods_after_opening_tags":["en:12-months"]
"periods_after_opening_hierarchy":["en:12-months"] 
"periods_after_opening":"12 M"
"periods_after_opening_debug_tags":[]

Images

No API is currently available, but the image path is predictable.

https://static.openbeautyfacts.org/images/lang/en/periods_after_opening/1-months.90x90.svg
…
https://static.openbeautyfacts.org/images/lang/en/periods_after_opening/12-months.90x90.svg