{"openapi":"3.1.0","info":{"title":"Food & Nutrition API","version":"1.0.0","description":"Look up packaged food products by barcode (EAN/UPC/GTIN) and get the product name, brand, ingredients, allergens, Nutri-Score, NOVA group, Eco-Score and per-100g nutrition facts — or search the catalogue by name. Backed by the Open Food Facts database. Ideal for nutrition trackers, diet and fitness apps, grocery and retail tools.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/food-api","description":"oanor gateway"}],"tags":[{"name":"Food"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/nutrition":{"get":{"operationId":"get_v1_nutrition","tags":["Food"],"summary":"Nutrition facts by barcode","description":"","parameters":[{"name":"barcode","in":"query","required":true,"description":"EAN/UPC/GTIN barcode","schema":{"type":"string"},"example":"3017620422003"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"barcode":"3017620422003","allergens":["milk","nuts","soybeans"],"nova_group":4,"nutriments":{"fat_100g":30.9,"salt_100g":0.107,"sodium_100g":0.0428,"sugars_100g":56.3,"proteins_100g":6.3,"energy_kcal_100g":539,"carbohydrates_100g":57.5,"saturated_fat_100g":10.6},"product_name":"Nutella","nutriscore_grade":"e"},"meta":{"timestamp":"2026-05-30T03:53:22.258Z","request_id":"c88a38cd-c469-4638-911e-41c979d328bd"},"status":"ok","message":"Nutrition retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/product":{"get":{"operationId":"get_v1_product","tags":["Food"],"summary":"Product by barcode","description":"","parameters":[{"name":"barcode","in":"query","required":true,"description":"EAN/UPC/GTIN barcode","schema":{"type":"string"},"example":"3017620422003"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"url":"https://world.openfoodfacts.org/product/3017620422003","image":"https://images.openfoodfacts.org/images/products/301/762/042/2003/front_en.820.400.jpg","brands":"Nutella","labels":["no-gluten","triman","Sans colorants","Sans conservateurs","Sans gluten","Sans matière grasse hydrogénée","Végétarien"],"barcode":"3017620422003","allergens":["milk","nuts","soybeans"],"countries":["france","italy","luxembourg","philippines","Allemagne","Belgique","Espagne","Inde","Maroc","Pays-Bas","Pologne","Roumanie","Royaume-Uni","Suisse","Turquie","États-Unis"],"categories":["Petit-déjeuners","Produits à tartiner","Produits à tartiner sucrés","Pâtes à tartiner"],"nova_group":4,"nutriments":{"fat_100g":30.9,"salt_100g":0.107,"sodium_100g":0.0428,"sugars_100g":56.3,"proteins_100g":6.3,"energy_kcal_100g":539,"carbohydrates_100g":57.5,"saturated_fat_100g":10.6},"product_name":"Nutella","ecoscore_grade":"unknown","ingredients_text":"Sucre, huile de palme, NOISETTES 13%, cacao maigre 7,4%, LAIT écrémé en poudre 6,6%, LACTOSERUM en poudre, émulsifiants: lécithines [SOJA), vanilline. Sans gluten.","nutriscore_grade":"e"},"meta":{"timestamp":"2026-05-30T03:53:22.755Z","request_id":"133b125a-bd17-470e-a258-f2d4ad64a7cc"},"status":"ok","message":"Product retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Food"],"summary":"Search products by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"nutella"},{"name":"limit","in":"query","required":false,"description":"Max 1-25","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"nutella","total":976,"results":[{"image":"https://images.openfoodfacts.org/images/products/301/762/042/2003/front_en.820.400.jpg","brands":"Nutella","barcode":"3017620422003","categories":["Petit-déjeuners","Produits à tartiner","Produits à tartiner sucrés","Pâtes à tartiner"],"nova_group":4,"product_name":"Nutella","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/301/762/042/5035/front_en.583.400.jpg","brands":"nutella","barcode":"3017620425035","quantity":"1 kg","categories":["pates-a-tartiner-au-chocolat","pates-a-tartiner-aux-noisettes","pates-a-tartiner-aux-noisettes-et-au-cacao","petit-dejeuners","produits-a-tartiner","produits-a-tartiner-sucres"],"nova_group":4,"product_name":"Nutella","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/301/762/042/9484/front_en.373.400.jpg","brands":"Ferrero, Nutella","barcode":"3017620429484","quantity":"825 g","categories":["breakfasts","spreads","sweet-spreads","pates-a-tartiner","hazelnut-spreads","chocolate-spreads","cocoa-and-hazelnuts-spreads","confectionary-based-spreads"],"nova_group":4,"product_name":"Nutella","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/800/050/042/6494/front_en.101.400.jpg","brands":"Ferrero, nutella","barcode":"8000500426494","quantity":"350 g","categories":["breakfasts","spreads","sweet-spreads","pates-a-tartiner","hazelnut-spreads","chocolate-spreads","cocoa-and-hazelnuts-spreads"],"nova_group":4,"product_name":"Nutella Plant-Based","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/000/008/017/6800/front_en.273.400.jpg","brands":"Ferrero, nutella","barcode":"80176800","quantity":"750g","categories":["snacks","breakfasts","spreads","sweet-spreads","pates-a-tartiner","hazelnut-spreads","chocolate-spreads","cocoa-and-hazelnuts-spreads"],"nova_group":4,"product_name":"Nutella","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/800/050/031/0427/front_fr.515.400.jpg","brands":"nutella","barcode":"8000500310427","quantity":"304 g","categories":["snacks","sweet-snacks","biscuits-and-cakes","biscuits-and-crackers","biscuits","biscuits-cookies-shelf-stable","Biscoitos recheados"],"nova_group":4,"product_name":"Biscuits croquants au coeur onctueux de Nutella®","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/000/005/903/2823/front_fr.280.400.jpg","brands":"Ferrero, Nutellagg","barcode":"59032823","quantity":"630 g (42 x 15 g)","categories":["breakfasts","spreads","sweet-spreads","spreadable-fats","pates-a-tartiner","hazelnut-spreads","chocolate-spreads","cocoa-and-hazelnuts-spreads","confectionary-based-spreads","Creme-para-barrar-de-avelã","Creme-para-barrar-de-avelã-e-cacau","Pequenos-alomoços"],"nova_group":4,"product_name":"nutella","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/800/050/017/9864/front_en.178.400.jpg","brands":"Ferrero, Nutella","barcode":"8000500179864","quantity":"600g","categories":["breakfasts","spreads","sweet-spreads","pates-a-tartiner","hazelnut-spreads","chocolate-spreads","cocoa-and-hazelnuts-spreads"],"nova_group":4,"product_name":"Nutella 600g","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/301/762/042/1006/front_fr.363.400.jpg","brands":"Ferrero","barcode":"3017620421006","quantity":"750 g","categories":["breakfasts","spreads","sweet-spreads","pates-a-tartiner","hazelnut-spreads","chocolate-spreads","cocoa-and-hazelnuts-spreads"],"nova_group":4,"product_name":"Pâte à tartiner Nutella noisettes et cacao - 750g","nutriscore_grade":"e"},{"image":"https://images.openfoodfacts.org/images/products/800/050/008/2379/front_en.167.400.jpg","brands":"Nutella","barcode":"8000500082379","quantity":"1000 g","categories":["breakfasts","spreads","festive-foods","sweet-spreads","christmas-foods-and-drinks","pates-a-tartiner","hazelnut-spreads","chocolate-spreads","cocoa-and-hazelnuts-spreads"],"nova_group":4,"product_name":"Nutella","nutriscore_grade":"e"}]},"meta":{"timestamp":"2026-05-30T03:53:27.672Z","request_id":"96969ded-41a7-4053-b696-82995bd5135f"},"status":"ok","message":"Product search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":5,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1500,"monthly_call_quota":50000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4900,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":12900,"monthly_call_quota":1000000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/food-api"}