Search Products
GEThttps://api-barcode-lookup.dataandapis.com/v1/products
Search Products is an endpoint of the Barcode Lookup API. Product name, brand, ingredients and Nutri-Score for 4.3 million barcodes.
Send your key in the X-Api-Key header. Each call costs 1 token; a free key includes 500 tokens a month.
Request
Query parameters
| Parameter | Example | |
|---|---|---|
| brand | Ferrero | Optional |
| category | Chocolate | Optional |
| country | France | Optional |
| dataset | food | Optional |
| has_image | true | Optional |
| limit | 20 | Optional |
| nova | 4 | Optional |
| nutriscore | Optional | |
| page | 1 | Optional |
| q | nutella | Optional |
Example request
curl
curl "https://api-barcode-lookup.dataandapis.com/v1/products?brand=Ferrero&category=Chocolate&country=France&dataset=food&has_image=true&limit=20&nova=4&page=1&q=nutella" \
-H "X-Api-Key: YOUR_API_KEY"Node.js
const res = await fetch("https://api-barcode-lookup.dataandapis.com/v1/products?brand=Ferrero&category=Chocolate&country=France&dataset=food&has_image=true&limit=20&nova=4&page=1&q=nutella", {
headers: { "X-Api-Key": process.env.DATAANDAPIS_KEY },
});
const data = await res.json();Python
import os, requests
r = requests.get(
"https://api-barcode-lookup.dataandapis.com/v1/products?brand=Ferrero&category=Chocolate&country=France&dataset=food&has_image=true&limit=20&nova=4&page=1&q=nutella",
headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()Example response
Example response{
"ok": true,
"total": 62,
"page": 1,
"limit": 20,
"count": 3,
"results": [
{
"barcode": "8000500045497",
"name": "Biscuits Nutella & Go x2 packs - 104g",
"brand": "Nutella, Ferrero, Nutella & go, Nutella & go !",
"quantity": "2 x 52 g",
"nutriscore": "e",
"nova": 4,
"image_url": "https://images.openfoodfacts.org/images/products/800/050/004/5497/front_fr.171.400.jpg",
"dataset": "food"
},
{
"barcode": "9300698000216",
"name": "nutella",
"brand": "Ferrero",
"quantity": "400 g",
"nutriscore": "e",
"nova": 4,
"image_url": "https://images.openfoodfacts.org/images/products/930/069/800/0216/front_en.44.400.jpg",
"dataset": "food"
},
{
…
Show full response
Example response
{
"ok": true,
"total": 62,
"page": 1,
"limit": 20,
"count": 3,
"results": [
{
"barcode": "8000500045497",
"name": "Biscuits Nutella & Go x2 packs - 104g",
"brand": "Nutella, Ferrero, Nutella & go, Nutella & go !",
"quantity": "2 x 52 g",
"nutriscore": "e",
"nova": 4,
"image_url": "https://images.openfoodfacts.org/images/products/800/050/004/5497/front_fr.171.400.jpg",
"dataset": "food"
},
{
"barcode": "9300698000216",
"name": "nutella",
"brand": "Ferrero",
"quantity": "400 g",
"nutriscore": "e",
"nova": 4,
"image_url": "https://images.openfoodfacts.org/images/products/930/069/800/0216/front_en.44.400.jpg",
"dataset": "food"
},
{
…{
"ok": true,
"total": 62,
"page": 1,
"limit": 20,
"count": 3,
"results": [
{
"barcode": "8000500045497",
"name": "Biscuits Nutella & Go x2 packs - 104g",
"brand": "Nutella, Ferrero, Nutella & go, Nutella & go !",
"quantity": "2 x 52 g",
"nutriscore": "e",
"nova": 4,
"image_url": "https://images.openfoodfacts.org/images/products/800/050/004/5497/front_fr.171.400.jpg",
"dataset": "food"
},
{
"barcode": "9300698000216",
"name": "nutella",
"brand": "Ferrero",
"quantity": "400 g",
"nutriscore": "e",
"nova": 4,
"image_url": "https://images.openfoodfacts.org/images/products/930/069/800/0216/front_en.44.400.jpg",
"dataset": "food"
},
{
"barcode": "80177173",
"name": "Nutella",
"brand": "Ferrero",
"quantity": "350 g",
"nutriscore": "e",
"nova": 4,
"image_url": "https://images.openfoodfacts.org/images/products/80177173/front_en.502.400.jpg",
"dataset": "food"
}
]
}