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ámetroEjemplo
brandFerreroOpcional
categoryChocolateOpcional
countryFranceOpcional
datasetfoodOpcional
has_imagetrueOpcional
limit20Opcional
nova4Opcional
nutriscoreOpcional
page1Opcional
qnutellaOpcional

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
{
  "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"
    }
  ]
}