Skip to main content

Catalog API overview

You can use the catalog API to create or update products and items. When you use the APIs to update your catalog, only the attributes contained in the API body are updated. The update uses an asynchronous process that can take an extended period of time to complete.

When you create a new product, it can take 1-3 business days for the new product to display in the storefront. When you update a product, it can take 2-3 hours for the update to display in the storefront.

When you update an item, it can take 2-3 hours for the update to display in the storefront.

note

To use Catalog APIs, contact your Instacart representative.

Products

Products are the same for all of a retailer's stores. This API includes common attributes like item_name, item_details, and remote_image_URL. For more information, see Product API.

Items

Items contain information that can vary from one retailer's store to another. This API includes unique attributes like price, available, and order_lead_time. Item attributes are different for each individual store. For more information, see Item API.