Skip to content

Reference: API CheatSheet#

This reference cheatsheet gives you a quick reminder to send requests to the OFF API.

If you are new to API usage you might look at the tutorial. Also, refer to the API reference documentation for complete information.

Add/Edit an Existing Product#

Indicate the absence of nutrition facts#

no_nutrition_data=on (indicates if the nutrition facts are not indicated on the food label)

Add nutrition facts values, units and base#

nutrition_data_per=100g

OR

nutrition_data_per=serving
serving_size=38g
nutriment_energy=450
nutriment_energy_unit=kJ

Adding values to a field that is already filled#

You just have to prefix add_ before the name of the field

add_categories
add_labels
add_brands

Search for Products#

Important: full text search currently works only for v1 API (or search-a-licious, which is in beta)

documentation for v1 Search API

Reference documentation for v2 search API

The future of search is the search-a-licious project, deployed, in beta, at search.openfoodfacts.org.

Get data for a list of products#

You can use comma to separate multiple values of a query parameter. This allows you to make bulk requests. The product result can also be limited to specified data using fields.

https://world.openfoodfacts.org/api/v2/search?code=3263859883713,8437011606013,6111069000451&fields=code,product_name