# Instacart Product API Documentation

<p><strong>Instacart Product API</strong> 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.</p><p>Send the <code>id</code> exactly as search returns it: an item id such as items_88059-20630136, a product id such as 20630136, or a product URL. Send <code>retailer</code> as the retailer slug that owns the product. An optional <code>zip</code> 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 <code>meta.nutrition</code> as available, gated or unavailable and <code>meta.price_source</code> 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.</p>

- **Documentation:** [https://scrappa.co/docs/instacart-api/instacart_product](https://scrappa.co/docs/instacart-api/instacart_product)
- **API group:** Instacart API
- **Endpoint:** `GET https://scrappa.co/api/instacart/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Item id, product id or product URL from search, for example items_88059-20630136. |
| `retailer` | string | No | Retailer slug that owns the product, for example safeway. |
| `zip` | string | No | Optional supported US ZIP (currently 10016); validity gate only, not echoed back |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or invalid. This response is not billable. |
| 404 | Not Found | No product with this id was found. This response is not billable. |
| 503 | Upstream Unavailable | Instacart could not be reached. This response is not billable. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
