Instacart Product API returns one grocery product from Instacart by its id. It adds the description and nutrition panel (serving size and nutrients) to the price, sale price, unit price, availability, brand, size and full-size image.
Send the id exactly as search returns it: an item id such as items_88059-20630136, a product id such as 20630136, or a product URL. Send retailer as the retailer slug that owns the product. An optional zip must be a supported ZIP (currently 10016); it is a validity gate and is not echoed back. The retailer and shop come from a prior search when present; the zone prefix in an item id is never used as a shop id. The ZIP is sent with the lookup. The response reports meta.nutrition as available, gated or unavailable and meta.price_source as search_cache or product_page. An unknown id answers 404 and is free. Ingredients and ratings are not published for anonymous requests and are left out. Costs 1 credit per successful request. Failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
Item id, product id or product URL from search, for example items_88059-20630136.
1234567890
string
Optional
Retailer slug that owns the product, for example safeway.
example
string
Optional
Optional supported US ZIP (currently 10016); validity gate only, not echoed back
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"product": {
"id": "items_88059-20630136",
"url": "https://www.instacart.com/products/20630136-organic-whole-milk?retailerSlug=safeway",
"name": "Organic Whole Milk",
"size": "1 gal",
"brand": "Safeway",
"image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_example.jpeg",
"price": 3.44,
"currency": "USD",
"nutrition": {
"nutrients": [
{
"name": "Calories",
"unit": "kcal",
"amount": 150
},
{
"name": "Total Fat",
"unit": "g",
"amount": 8
},
{
"name": "Protein",
"unit": "g",
"amount": 8
}
],
"serving_size": "1 cup (240 mL)"
},
"product_id": "20630136",
"description": "Fresh organic whole milk.",
"retailer_id": 118,
"availability": "in_stock"
}
},
"meta": {
"credits": 1,
"billable": true,
"nutrition": "available",
"price_source": "search_cache",
"endpoint_family": "product"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The id is missing or invalid. This response is not billable.
{
"errors": {
"id": [
"Use an item id, a product id or a product URL from search."
]
},
"message": "The request validation failed"
}Not Found
No product with this id was found. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Instacart could not be reached. This response is not billable. Retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Instacart could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.