Product API
Endpoints
GET All Products

Retrieve a list of all products

GET Retrieve a list of all products

/products/all

This endpoint allows you to retrieve detailed information about all products.

Success 200

FieldParameterDescription
product_idstringUnique ID of the product.
product_namestringThe name of the product.
producerstringThe producer of the product.
brandstringThe brand of the product.
producer_addressstringThe address of the producer.
producer_statestringThe state of the producer.
producer_citystringThe city of the producer.
producer_country_codestringThe country code of the producer.
producer_postal_codestringThe postal code of the producer.
upcstringThe UPC code of the product.
groceryobjectThe corresponding grocery of the product. Each object has the following fields: grocery_id, category, subcategory
storesarray of objectsThe array of stores that carry the product. Each object has the following fields: store_id, store_name, price, sale_price, categories, subcategories, currency, stock, sku
weightobjectThe weight of the product. Each object has the following fields: value, unit
sizeobjectThe size of the product. Each object has the following fields: lenght, width, heigth, unit
macronutrientsobjectThe macronutrients of the product. Each object has the following fields: fat, saturated_fat, calories, carbs, proteins, total_sugars
micronutrientsobjectThe micronutrients of the product. Each object has the following fields: vitamin_d, vitamin_a, calcium, iron, potassium

Example Response

{
    "product_id": "19696639",
    "product_name": "Kroger 2% Reduced Fat Milk",
    "producer": "Kroger",
    "brand": "Kroger",
    "producer_address": "1014 Vine St.",
    "producer_state": "Ohio",
    "producer_city": "Cincinnati",
    "producer_country_code": "OH",
    "producer_postal_code": "45202",
    "upc": "01111041600",
    "grocery" {
	    "grocery_id": 49817,
	    "category": "Dairy",
	    "subcategory": "Milk"
}
    "stores": [
        {
            "store_id": "291",
            "store_name": "FoodsCo",
            "price": 2.69,
            "sale_price": 0,
            "categories": ["Dairy"],
            "subcategories": ["Milk","Reduced Fat Milk"],
            "currency": "USD",
            "stock": 50,
            "sku": "295703"
        },
        {
            "store_id": "475",
            "store_name": "Walgreens",
            "price": 2.74,
            "sale_price": 0,
            "categories": ["Dairy"],
            "subcategories": ["Milk","Reduced Fat Milk"],
            "currency": "USD",
            "stock": 30,
            "sku": "626406"
        }
    ],
    "weight": {
        "value": 4.42,
        "unit": "kg"
    },
    "size": {
        "lenght": 4.0,
        "width": 4.0,
        "heigth": 9.25,
        "unit": "inches"
    },
    "macronutrients": {
        "fat": 5,
        "saturated_fat": 3,
        "calories": 216,
        "carbs": 12,
        "proteins": 8,
        "total_sugars": 12
    },
    "micronutrients": {
        "vitamin_d": 2.5,
        "vitamin_a": 150,
        "calcium": 290,
        "iron": 0,
        "potassium": 380
    }
}