instacart · Schema

Item

Properties

Name Type Description
product_code string The retailer's unique product identifier linking this item to its parent product.
store_code string The retailer's unique store identifier where this item is sold.
price number The current selling price of the item at this store.
sale_price number The promotional or sale price, if applicable.
sale_start_date string The start date of the sale period.
sale_end_date string The end date of the sale period.
available boolean Whether the item is currently available for purchase at this store.
inventory_count integer The current inventory count at this store.
aisle string The store aisle where the item is located.
shelf string The shelf location within the aisle.
View JSON Schema on GitHub

JSON Schema

instacart-item-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Item",
  "title": "Item",
  "type": "object",
  "required": [
    "product_code",
    "store_code"
  ],
  "properties": {
    "product_code": {
      "type": "string",
      "description": "The retailer's unique 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",
      "format": "double",
      "description": "The current selling price of the item at this store.",
      "minimum": 0
    },
    "sale_price": {
      "type": "number",
      "format": "double",
      "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."
    }
  }
}