API de códigos de barras

Integrate barcode lookup and analysis directly into your applications.

POST

1. Autenticación

Este endpoint permite autenticarse y obtener un token de acceso. El token es necesario para las siguientes solicitudes a la API.

/api/auth/getToken
Request Body
{
  "userKey": "YOUR_USER_KEY",
  "apiKey": "YOUR_API_KEY"
}
Pruébalo
POST

2. Obtener código de barras

Este endpoint te permite obtener los datos de un código de barras concreto, como el nombre del producto, el precio y la disponibilidad.

Autorización:: Esta solicitud requiere un token válido en el
/api/barcode
Request
{
  "barcode": "8690632994802"
}
Response Example
[
  {
    "barcode": "8690...",
    "text": "Product Name...",
    "prices": []
  }
]
Pruébalo
Auth
* Auto-filled from Authentication step
Código de barras

                            
POST

3. Información nutricional

Calorías, grasas, hidratos de carbono, proteínas, azúcares, sodio, vitaminas y minerales de un producto, por 100 g (o 100 ml) y por porción, con los ingredientes. Datos de USDA FoodData Central y Open Food Facts. Cada llamada cuenta para tu cuota diaria, igual que una consulta de código de barras.

Autorización:: Esta solicitud requiere un token válido en el
/api/nutrition
Request
{
  "barcode": "0016000275287"
}
Notas
  • Unidades: energía en kcal; nutrientes en g, mg o mcg (µg).
  • servingSize, servingUnit y perServing están vacíos cuando la fuente no indica el tamaño de la porción.
  • dailyValue: porcentaje del valor diario de EE. UU. (dieta de 2000 kcal); vacío si no existe.
  • 404 con {"error": "NO_NUTRITION_FACTS"} cuando no tenemos información nutricional del producto.
  • source: usda-fdc u openfoodfacts. Los datos de Open Food Facts están bajo la licencia ODbL: menciona a Open Food Facts donde los muestres.
Response Example
{
  "barcode": "0016000275287",
  "source": "usda-fdc",
  "servingSize": 40.0,
  "servingUnit": "g",
  "householdServing": "1 cup (40 g)",
  "packageWeight": "18 oz",
  "category": "Cereal",
  "ingredients": "Whole grain oats, sugar, ...",
  "nutrients": [
    { "key": "energy", "unit": "kcal",
      "per100": 375.0, "perServing": 150.0,
      "dailyValue": null },
    { "key": "fat", "unit": "g",
      "per100": 5.0, "perServing": 2.0,
      "dailyValue": 3 },
    { "key": "sodium", "unit": "mg",
      "per100": 475.0, "perServing": 190.0,
      "dailyValue": 8 }
  ]
}

Claves de nutrientes: energy, fat, saturatedFat, transFat, cholesterol, sodium, carbohydrate, fiber, sugars, addedSugars, protein, vitaminD, calcium, iron, potassium (orden de la etiqueta de EE. UU.; solo las que indica el producto).

Pruébalo
Auth

                            
POST

4. Análisis del código de barras

Este endpoint analiza el código de barras indicado y devuelve datos como el país de origen, el código del fabricante y el código del producto.

/api/analysis
Pruébalo
Auth
Código de barras