instacart · Schema

Instacart Product

Represents a product in the Instacart Catalog system. Products are defined at the retailer level and are the same across all of a retailer's stores. Store-specific attributes such as pricing and availability are managed through the Item entity.

Properties

Name	Type	Description
product_code	string	The retailer's unique product identifier used to match the product in the Instacart system.
name	string	The display name of the product.
brand	string	The brand name of the product.
description	string	A detailed description of the product.
size	string	The size or quantity description of the product, such as 12 oz or 6-pack.
upc	string	The Universal Product Code, typically 12 or 14 digits.
image_url	string	URL to the primary product image.
category	string	The product category in the retailer's taxonomy.
subcategory	string	The product subcategory.
department	string	The store department the product belongs to.
attributes	object	Additional product attributes such as dietary information, certifications, or nutritional details.
items	array	Store-specific item records associated with this product.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://instacart.com/schemas/instacart/product.json",
  "title": "Instacart Product",
  "description": "Represents a product in the Instacart Catalog system. Products are defined at the retailer level and are the same across all of a retailer's stores. Store-specific attributes such as pricing and availability are managed through the Item entity.",
  "type": "object",
  "required": ["product_code", "name"],
  "properties": {
    "product_code": {
      "type": "string",
      "description": "The retailer's unique product identifier used to match the product in the Instacart system."
    },
    "name": {
      "type": "string",
      "description": "The display name of the product.",
      "minLength": 1,
      "maxLength": 500
    },
    "brand": {
      "type": "string",
      "description": "The brand name of the product."
    },
    "description": {
      "type": "string",
      "description": "A detailed description of the product."
    },
    "size": {
      "type": "string",
      "description": "The size or quantity description of the product, such as 12 oz or 6-pack."
    },
    "upc": {
      "type": "string",
      "pattern": "^[0-9]{12,14}$",
      "description": "The Universal Product Code, typically 12 or 14 digits."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "URL to the primary product image."
    },
    "category": {
      "type": "string",
      "description": "The product category in the retailer's taxonomy."
    },
    "subcategory": {
      "type": "string",
      "description": "The product subcategory."
    },
    "department": {
      "type": "string",
      "description": "The store department the product belongs to."
    },
    "attributes": {
      "type": "object",
      "description": "Additional product attributes such as dietary information, certifications, or nutritional details.",
      "additionalProperties": {
        "type": "string"
      }
    },
    "items": {
      "type": "array",
      "description": "Store-specific item records associated with this product.",
      "items": {
        "$ref": "#/$defs/Item"
      }
    }
  },
  "$defs": {
    "Item": {
      "type": "object",
      "description": "An item representing a product at a specific store location, containing store-specific attributes like pricing and availability.",
      "required": ["product_code", "store_code"],
      "properties": {
        "product_code": {
          "type": "string",
          "description": "The retailer's product identifier linking this item to its parent product."
        },
        "store_code": {
          "type": "string",
          "description": "The retailer's unique store identifier where this item is sold."
        },
        "price": {
          "type": "number",
          "description": "The current selling price of the item at this store.",
          "minimum": 0
        },
        "sale_price": {
          "type": "number",
          "description": "The promotional or sale price, if applicable.",
          "minimum": 0
        },
        "sale_start_date": {
          "type": "string",
          "format": "date",
          "description": "The start date of the sale period."
        },
        "sale_end_date": {
          "type": "string",
          "format": "date",
          "description": "The end date of the sale period."
        },
        "available": {
          "type": "boolean",
          "description": "Whether the item is currently available for purchase at this store."
        },
        "inventory_count": {
          "type": "integer",
          "description": "The current inventory count at this store.",
          "minimum": 0
        },
        "aisle": {
          "type": "string",
          "description": "The store aisle where the item is located."
        },
        "shelf": {
          "type": "string",
          "description": "The shelf location within the aisle."
        }
      }
    }
  }
}