Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

instacart Products API

Endpoints for creating and updating products in the retailer's catalog on Instacart. Products are the same across all of a retailer's stores.

instacart Products API is one of 10 APIs that instacart publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Products. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 3 operations across 3 paths, and defines 10 schemas. It is described by OpenAPI 3.1.0, at version 2.0.

Requests are made against a single base URL, https://connect.instacart.com.

3 operations 3 paths 10 schemas 3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0
Base URL
https://connect.instacart.com
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

instacart Products API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — OAuth 2.0 Bearer token obtained using client credentials with the connect:dataingestion scope.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 POST. Each is listed below with its method, path, parameters, and response codes.

Products 3

Endpoints for creating and updating products in the retailer's catalog on Instacart. Products are the same across all of a retailer's stores.

POST
/v2/data_ingestion/catalog/product/submission
Create or update products
submitProducts body → 200400401429
POST
/idp/v1/products/products_link
Create a shopping list page
createShoppingListPage body → 200400401429
POST
/idp/v1/products/recipe
Create a recipe page
createRecipePage body → 200400401429

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Product (11 properties), RecipeRequest (10 properties), LineItem (8 properties), ShoppingListRequest (7 properties). Each schema is shown below with its type and property counts.

Ingredient
object
6 properties 1 required
Error_2
object
2 properties
ProductSubmissionRequest
object
1 property 1 required
RecipeRequest
object
10 properties 2 required
SubmissionResponse
object
4 properties
ProductsLinkResponse
object
1 property
ShoppingListRequest
object
7 properties 2 required
Product
object
11 properties 2 required
Error
object
2 properties
LineItem
object
8 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

instacart-products-api-openapi.yml Raw ↑

Other APIs instacart publishes across the network.

Instacart Shopping Widgets
instacart Authentication API
instacart Chat API
instacart Delivery API
instacart Items API
instacart Last Mile Delivery API
instacart Orders API
instacart Pickup API
instacart Replacements API