Products
Get Product Data
Retrieve information for a product with a specific barcode.
The fields parameter allows to specify what fields to retrieve.
Path Parameters
barcodestring
The barcode of the product to be fetched
Query Parameters
product_type?string
Used for READ queries for one product. Expected product type of the requested product. Defaults to the product type of the server the query is sent to (e.g. 'food' for Open Food Facts, 'beauty' for Open Beauty Facts, etc.). 'all' matches all product types. If the product exists on a different server that matches the requested product type, the API will return a 302 redirect to the correct server. Otherwise, the API will return a 404 error. It is possible that new product types will be added in the future.
Value in
"all" | "beauty" | "food" | "petfood" | "product"cc?string
2 letter code of the country of the user. Used for localizing some fields in returned values (e.g. knowledge panels). If not passed, the country may be inferred by the IP address of the request.
lc?string
2 letter code of the language of the user. Used for localizing some fields in returned values (e.g. knowledge panels). If not passed, the language may be inferred by the Accept-Language header of the request.
tags_lc?string
2 letter language code to request names of tags in a specific language. For READ requests: if passed, all taxonomized tags of the response will include a lc_name property with the translation in the requested language, if available. Otherwise, the property value will contain the name in the original language, prefixed by the 2 language code and a colon.
fields?string
Comma separated list of fields requested in the response.
Special values:
- "none": returns no fields
- "raw": returns all fields as stored internally in the database
- "all": returns all fields except generated fields that need to be explicitly requested such as "knowledge_panels".
Defaults to "all" for READ requests. The "all" value can also be combined with fields like "attribute_groups" and "knowledge_panels".'
knowledge_panels_included?string
When knowledge_panels are requested, you can specify which panels should be in the response. All the others will be excluded.
knowledge_panels_excluded?string
When knowledge_panels are requested, you can specify which panels to exclude from the response. All the others will be included. If a panel is both excluded and included (with the knowledge_panels_excluded parameter), it will be excluded.
Response Body
curl -X GET "https://world.openfoodfacts.org/api/v3/product/3017620422003?product_type=all&cc=us&lc=fr&tags_lc=string&fields=string&knowledge_panels_included=health_card%2C+environment_card&knowledge_panels_excluded=health_card%2C+environment_card"{
"status_id": "success_with_errors",
"result": {
"id": "product_updated",
"name": "Product updated",
"lc_name": "Produit mis à jour"
},
"errors": [
{
"message": {
"id": "sugars_higher_than_carbohydrates",
"name": "Sugars higher than carbohydrates",
"lc_name": "Sucres plus élevés que les glucides",
"description": "Sugars (40g) are higher than carbohydrates (35g).",
"lc_description": "Les sucres (40g) sont plus élévés que les glucdes."
},
"field": {
"id": "nutriment.sugars",
"value": "40"
},
"impact": {
"id": "nutrients_not_updated",
"name": "Nutrients not updated",
"lc_name": "Nutriments non mis à jour",
"description": "The nutrients were not updated.",
"lc_description": "Les nutriments n'ont pas été mis à jour."
}
}
],
"product": {
"abbreviated_product_name": "string",
"product_type": "beauty",
"code": "string",
"codes_tags": [
"code-13"
],
"generic_name": "string",
"id": "string",
"lc": "string",
"lang": "string",
"nova_group": 0,
"nova_groups": "string",
"obsolete": "string",
"obsolete_since_date": "string",
"product_name": "string",
"product_name_en": "string",
"product_quantity": "500",
"product_quantity_unit": "g",
"quantity": "3 x 150 g",
"schema_version": 999,
"additives_n": 0,
"checked": "string",
"complete": 0,
"completeness": 0,
"ecoscore_grade": "string",
"ecoscore_score": 0,
"food_groups": "string",
"food_groups_tags": [
"string"
],
"nutrient_levels": {
"fat": "low",
"salt": "low",
"saturated-fat": "low",
"sugars": "low"
},
"packaging_text": "packaging_text_en",
"packagings": [
{
"number_of_units": 6,
"shape": {
"id": "en:bottle",
"lc_name": "bouteille"
},
"material": {
"id": "en:bottle",
"lc_name": "bouteille"
},
"recycling": {
"id": "en:bottle",
"lc_name": "bouteille"
},
"quantity_per_unit": "25 cl",
"quantity_per_unit_value": 25,
"quantity_per_unit_unit": "cl",
"weight_specified": 30,
"weight_measured": 32,
"weight_estimated": 26,
"weight": 30,
"weight_source_id": "specified"
}
],
"packagings_complete": 1,
"pnns_groups_1": "string",
"pnns_groups_1_tags": [
"string"
],
"pnns_groups_2": "string",
"pnns_groups_2_tags": [
"string"
],
"popularity_key": 0,
"popularity_tags": [
"bottom-25-percent-scans-2020",
"top-85-percent-scans-2021",
"top-90-percent-scans-2022",
"top-country-it-scans-2019",
"top-100000-mg-scans-2024"
],
"scans_n": 0,
"unique_scans_n": 0,
"serving_quantity": "string",
"serving_quantity_unit": "g",
"serving_size": "string",
"brands": "string",
"brands_hierarchy": [
"string"
],
"brands_lc": "string",
"brands_tags": [
"string"
],
"categories": "string",
"categories_hierarchy": [
"string"
],
"categories_lc": "string",
"categories_tags": [
"string"
],
"checkers_tags": [
"string"
],
"cities": "string",
"cities_tags": [
{}
],
"correctors_tags": [
"string"
],
"countries": "string",
"countries_hierarchy": [
"string"
],
"countries_lc": "string",
"countries_tags": [
"string"
],
"ecoscore_tags": [
"string"
],
"emb_codes": "EMB 2013330",
"emb_codes_orig": "string",
"emb_codes_tags": [
{}
],
"labels": "string",
"labels_hierarchy": [
"string"
],
"labels_lc": "string",
"labels_tags": [
"string"
],
"entry_dates_tags": [
"2016-03-11",
"2016-03",
"2016"
],
"manufacturing_places": "string",
"manufacturing_places_tags": [
"string"
],
"nova_groups_tags": [
"string"
],
"nutrient_levels_tags": [
"string"
],
"images": {
"uploaded": {},
"selected": {
"front": {},
"ingredients": {},
"nutrition": {},
"packaging": {}
}
},
"selected_images": {},
"last_image_dates_tags": [
"string"
],
"last_image_t": 0,
"ecoscore_data": {
"adjustments": {
"origins_of_ingredients": {
"aggregated_origins": [
{
"epi_score": "string",
"origin": "string",
"percent": 0,
"transportation_score": null
}
],
"epi_score": 0,
"epi_value": 0,
"origins_from_categories": [
"string"
],
"origins_from_origins_field": [
"string"
],
"transportation_score": 0,
"transportation_scores": {
"property1": 0,
"property2": 0
},
"transportation_value": 0,
"transportation_values": {
"property1": 0,
"property2": 0
},
"value": 0,
"values": {
"property1": 0,
"property2": 0
},
"warning": "string"
},
"packaging": {
"non_recyclable_and_non_biodegradable_materials": 0,
"packagings": [
{
"ecoscore_material_score": 0,
"ecoscore_shape_ratio": 0,
"material": "string",
"shape": "string",
"number_of_units": 1,
"quantity_per_unit": "33 cL",
"quantity_per_unit_unit": "cl",
"quantity_per_unit_value": 33,
"recycling": "en:recycle-in-sorting-bin",
"weight_measured": 12.08
}
],
"score": 0,
"value": 0,
"warning": "string"
},
"production_system": {
"labels": "vegan",
"value": 0,
"warning": "string"
},
"threatened_species": {
"ingredient": "string",
"value": 0
}
},
"agribalyse": {
"agribalyse_proxy_food_code": "string",
"agribalyse_food_code": "string",
"co2_agriculture": 0,
"co2_consumption": 0,
"co2_distribution": 0,
"co2_packaging": 0,
"co2_processing": 0,
"co2_total": 0,
"co2_transportation": 0,
"code": "string",
"dqr": "string",
"ef_agriculture": 0,
"ef_consumption": 0,
"ef_distribution": 0,
"ef_packaging": 0,
"ef_processing": 0,
"ef_total": 0,
"ef_transportation": 0,
"is_beverage": 0,
"name_en": "string",
"score": 0,
"version": "string"
},
"grade": "string",
"grades": {},
"missing": {
"labels": 0,
"origins": 0,
"packagings": 0
},
"missing_data_warning": 0,
"previous_data": {
"grade": "string",
"score": 0,
"agribalyse": {
"agribalyse_proxy_food_code": "string",
"agribalyse_food_code": "string",
"co2_agriculture": 0,
"co2_consumption": 0,
"co2_distribution": 0,
"co2_packaging": 0,
"co2_processing": 0,
"co2_total": 0,
"co2_transportation": 0,
"code": "string",
"dqr": "string",
"ef_agriculture": 0,
"ef_consumption": 0,
"ef_distribution": 0,
"ef_packaging": 0,
"ef_processing": 0,
"ef_total": 0,
"ef_transportation": 0,
"is_beverage": 0,
"name_en": "string",
"score": 0,
"version": "string"
}
},
"score": 0,
"scores": {},
"status": "string"
},
"ecoscore_extended_data_version": "string",
"environment_impact_level": "string",
"environment_impact_level_tags": [
{}
],
"additives_tags": [
"string"
],
"allergens": "string",
"allergens_lc": "string",
"allergens_hierarchy": [
"string"
],
"allergens_tags": [
"string"
],
"ingredients": [
{
"id": "string",
"ingredients": [
{}
],
"percent": 0,
"percent_estimate": 0,
"percent_max": "string",
"percent_min": 0,
"text": "string",
"vegan": "string",
"vegetarian": "string"
}
],
"ingredients_analysis": {
"en:palm-oil": [
"string"
],
"en:vegan-status-unknown": [
"string"
],
"en:vegetarian-status-unknown": [
"string"
]
},
"ingredients_analysis_tags": [
"string"
],
"ingredients_from_or_that_may_be_from_palm_oil_n": 0,
"ingredients_from_palm_oil_n": 0,
"ingredients_from_palm_oil_tags": [
{}
],
"ingredients_hierarchy": [
"string"
],
"ingredients_n": 0,
"ingredients_n_tags": [
"string"
],
"ingredients_original_tags": [
"string"
],
"ingredients_percent_analysis": 0,
"ingredients_sweeteners_n": 0,
"ingredients_non_nutritive_sweeteners_n": 0,
"ingredients_tags": [
"string"
],
"ingredients_lc": "string",
"ingredients_text": "Farine de blé* 67,4%, sucre de canne*, huile de tournesol oléique*, graines de chia* 5,2%, son de blé*, oranges déshydratées * 0,9%, farine de riz*, poudres à lever (acide citrique, carbonates de sodium), arôme naturel d'orange.\n",
"ingredients_text_with_allergens": "Farine de <span class=\"allergen\">blé*</span> 67,4%, sucre de canne*, huile de tournesol oléique*, graines de chia* 5,2%, <span class=\"allergen\">son de blé*</span>, oranges déshydratées * 0,9%, farine de riz*, poudres à lever (acide citrique, carbonates de sodium), arôme naturel d'orange.\n",
"ingredients_that_may_be_from_palm_oil_n": 0,
"ingredients_that_may_be_from_palm_oil_tags": [
{}
],
"ingredients_with_specified_percent_n": 0,
"ingredients_with_specified_percent_sum": 0,
"ingredients_with_unspecified_percent_n": 0,
"ingredients_with_unspecified_percent_sum": 0,
"known_ingredients_n": 0,
"origins": "string",
"origins_hierarchy": [
{}
],
"origins_lc": "string",
"origins_tags": [
{}
],
"traces": "string",
"traces_hierarchy": [
{}
],
"traces_lc": "string",
"traces_tags": [
{}
],
"unknown_ingredients_n": 0,
"nutrition": {
"nutrient_set_preferred": {
"preparation": "as_sold",
"per": "100g",
"per_quantity": 250,
"per_unit": "g",
"nutrients": {
"energy": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"energy_kcal": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"energy_kj": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"fat": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"saturated-fat": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"trans-fat": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"cholesterol": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"salt": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"sodium": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"carbohydrates": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"carbohydrates-total": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"fiber": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"sugars": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"added-sugars": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"proteins": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"vitamin-d": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"calcium": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"iron": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"potassium": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "packaging",
"source_per": "100g"
},
"property1": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "string",
"source_per": "string"
},
"property2": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<",
"source": "string",
"source_per": "string"
}
}
},
"nutrient_sets": [
{
"nutrients": {
"energy": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"energy_kcal": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"energy_kj": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"fat": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"saturated-fat": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"trans-fat": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"cholesterol": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"salt": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"sodium": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"carbohydrates-total": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"carbohydrates": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"fiber": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"sugars": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"added-sugars": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"proteins": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"vitamin-d": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"calcium": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"iron": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"potassium": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"property1": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
},
"property2": {
"value_string": "2.0",
"value": 2,
"unit": "公斤",
"modifier": "<"
}
},
"preparation": "as_sold",
"per": "100g",
"per_quantity": 250,
"per_unit": "g",
"source": "packaging",
"source_description": "USDA non-branded foods 2025/04",
"last_updated_t": 1631270265,
"unspecified_nutrients": [
"fibers"
]
}
]
},
"nutriscore": {
"2021": {
"category_available": 1,
"grade": "d",
"nutrients_available": 1,
"nutriscore_applicable": 1,
"nutriscore_computed": 1,
"score": 13,
"data": {
"is_beverage": 0,
"is_cheese": 0,
"is_water": 0,
"is_fat": 0,
"energy": 1996,
"energy_points": 5,
"energy_value": 1996,
"fiber": 3.8,
"fiber_points": 4,
"fiber_value": 3.8,
"fruits_vegetables_nuts_colza_walnut_olive_oils": 0,
"fruits_vegetables_nuts_colza_walnut_olive_oils_points": 0,
"fruits_vegetables_nuts_colza_walnut_olive_oils_value": 0,
"proteins": 6.6,
"proteins_points": 4,
"proteins_value": 6.6,
"saturated_fat": 6.2,
"saturated_fat_points": 6,
"saturated_fat_value": 6.2,
"sodium": 210,
"sodium_points": 2,
"sodium_value": 210,
"sugars": 21.5,
"sugars_points": 4,
"sugars_value": 21.5,
"negative_points": 17,
"positive_points": 4,
"grade": "d",
"score": 13
}
},
"2023": {
"category_available": 1,
"grade": "d",
"nutrients_available": 1,
"nutriscore_applicable": 1,
"nutriscore_computed": 1,
"score": 13,
"data": {
"is_beverage": 0,
"is_cheese": 0,
"is_water": 0,
"is_fat_oil_nuts_seeds": 0,
"is_red_meat_product": 0,
"components": {
"negative": [
{
"id": "energy",
"points": 5,
"points_max": 10,
"unit": "kJ",
"value": 21.5
}
],
"positive": [
{
"id": "energy",
"points": 5,
"points_max": 10,
"unit": "kJ",
"value": 21.5
}
]
},
"count_proteins": 0,
"count_proteins_reason": "negative_points_greater_than_or_equal_to_11",
"negative_points": 19,
"positive_points": 1,
"negative_points_max": 55,
"positive_points_max": 10,
"positive_nutrients": [
"fiber",
"fruits_vegetables_legumes"
]
}
}
},
"nutriscore_2021_tags": [
"d"
],
"nutriscore_2023_tags": [
"d"
],
"nutriscore_data": {
"is_beverage": 0,
"is_cheese": 0,
"is_water": 0,
"is_fat": 0,
"energy": 1996,
"energy_points": 5,
"energy_value": 1996,
"fiber": 3.8,
"fiber_points": 4,
"fiber_value": 3.8,
"fruits_vegetables_nuts_colza_walnut_olive_oils": 0,
"fruits_vegetables_nuts_colza_walnut_olive_oils_points": 0,
"fruits_vegetables_nuts_colza_walnut_olive_oils_value": 0,
"proteins": 6.6,
"proteins_points": 4,
"proteins_value": 6.6,
"saturated_fat": 6.2,
"saturated_fat_points": 6,
"saturated_fat_value": 6.2,
"sodium": 210,
"sodium_points": 2,
"sodium_value": 210,
"sugars": 21.5,
"sugars_points": 4,
"sugars_value": 21.5,
"negative_points": 17,
"positive_points": 4,
"grade": "d",
"score": 13
},
"nutriscore_grade": "d",
"nutriscore_score": 13,
"nutriscore_score_opposite": -13,
"nutriscore_tags": [
"d"
],
"nutriscore_version": "string",
"data_quality_bugs_tags": [
"string"
],
"data_quality_errors_tags": [
"string"
],
"data_quality_info_tags": [
"string"
],
"data_quality_tags": [
"string"
],
"data_quality_warnings_tags": [
"string"
],
"data_sources": "string",
"data_sources_tags": [
"string"
],
"last_check_dates_tags": [
"string"
],
"last_checked_t": 0,
"last_checker": "string",
"states": "string",
"states_hierarchy": [
"string"
],
"states_tags": [
"string"
],
"misc_tags": [
"string"
],
"additives_original_tags": [
"string"
],
"additives_prev_original_tags": [
"string"
],
"added_countries_tags": [
{}
],
"allergens_from_ingredients": "string",
"allergens_from_user": "string",
"amino_acids_prev_tags": [
{}
],
"amino_acids_tags": [
{}
],
"carbon_footprint_percent_of_known_ingredients": 0,
"categories_properties": {
"agribalyse_food_code:en": "string",
"agribalyse_proxy_food_code:en": "string",
"ciqual_food_code:en": "string"
},
"categories_properties_tags": [
"string"
],
"category_properties": {
"property1": "string",
"property2": "string"
},
"ciqual_food_name_tags": [
"string"
],
"compared_to_category": "string",
"conservation_conditions": "string",
"customer_service": "string",
"expiration_date": "string",
"link": "string",
"main_countries_tags": [
{}
],
"minerals_prev_tags": [
{}
],
"minerals_tags": [
{}
],
"owner_fields": {
"additionalProperties": 0
},
"nova_groups_markers": {
"property1": [
[
"string"
]
],
"property2": [
[
"string"
]
]
},
"nucleotides_tags": [
{}
],
"origin": "string",
"purchase_places": "Paris",
"purchase_places_tags": [
"string"
],
"stores": "Walmart",
"stores_tags": [
"string"
],
"traces_from_ingredients": "string",
"traces_from_user": "string",
"created_t": 1457680652,
"creator": "string",
"editors_tags": [
"string"
],
"informers_tags": [
"string"
],
"interface_version_created": "string",
"interface_version_modified": "string",
"languages": {},
"languages_codes": {},
"languages_hierarchy": [
"string"
],
"languages_tags": [
"string"
],
"last_edit_dates_tags": [
"string"
],
"last_editor": "string",
"last_modified_by": "sebleouf",
"last_modified_t": 0,
"last_updated_t": 0,
"owner": "string",
"owners_tags": "string",
"photographers_tags": [
"string"
],
"rev": 0,
"sources": [
{
"fields": [
"string"
],
"id": "string",
"images": [
{}
],
"import_t": 0,
"manufacturer": 0,
"name": "string",
"source_licence": "string",
"source_licence_url": "string",
"url": null
}
],
"sources_fields": {
"org-gs1": {
"gln": "string",
"gpcCategoryCode": "string",
"gpcCategoryName": "string",
"isAllergenRelevantDataProvided": "string",
"lastChangeDateTime": "string",
"partyName": "string",
"productionVariantDescription": "string",
"publicationDateTime": "string"
}
},
"teams": "string",
"teams_tags": [
"string"
],
"update_key": "string",
"knowledge_panels": {
"additionalProperties": "string"
},
"attribute_groups": [
{
"id": "string",
"status": "known",
"title": "Does not contain: Molluscs",
"match": 100,
"grade": "unknown",
"name": "string",
"icon_url": "string",
"description": "string",
"description_short": "string"
}
]
}
}Empty
Empty