Search Products
GEThttps://api-barcode-lookup.dataandapis.com/v1/products
Search Products es un endpoint de Barcode Lookup API. Nombre, marca, ingredientes y Nutri-Score de 4,3 millones de códigos de barras.
Envía tu clave en la cabecera X-Api-Key. Cada llamada cuesta 1 token; una clave gratuita incluye 500 tokens al mes.
Petición
Parámetros de consulta
| Parámetro | Ejemplo | |
|---|---|---|
| brand | Ferrero | Opcional |
| category | Chocolate | Opcional |
| country | France | Opcional |
| dataset | food | Opcional |
| has_image | true | Opcional |
| limit | 20 | Opcional |
| nova | 4 | Opcional |
| nutriscore | Opcional | |
| page | 1 | Opcional |
| q | nutella | Opcional |
Petición de ejemplo
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()Respuesta de ejemplo
Respuesta de ejemplo{
"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"
},
{
…
Ver la respuesta completa
Respuesta de ejemplo
{
"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"
}
]
}
