# H-E-B Product API Documentation

<p><strong>H-E-B Product API</strong> returns one grocery product from heb.com by its <code>id</code>, the numeric productId from search. It adds the description, ingredients, nutrition panel, safety warning, preparation instructions, coupons and similar product ids to the search fields.</p><p>Send an <code>id</code> exactly as search returns it, for example 314124. An optional public <code>storeId</code> (default 590) and <code>shoppingContext</code> set the price context. An unknown id answers 404 and is free. Prices are in US dollars. Fields H-E-B does not publish for a product are left out.</p><p>Costs 1 credit per successful request. Not found and failed requests are free.</p>

- **Documentation:** [https://scrappa.co/docs/heb-api/heb_product](https://scrappa.co/docs/heb-api/heb_product)
- **API group:** H-E-B API
- **Endpoint:** `GET https://scrappa.co/api/heb/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 | Numeric product id from search, for example 314124. |
| `storeId` | integer | No | Public H-E-B store id, default 590. |
| `shoppingContext` | string | No | CURBSIDE_PICKUP or CURBSIDE_DELIVERY. |

## Example response

```json
{
    "data": {
        "product": {
            "id": "314124",
            "name": "H-E-B Whole Milk Gallon",
            "size": "1 gal",
            "brand": "H-E-B",
            "price": 3.29,
            "currency": "USD",
            "nutrition": {
                "nutrients": [
                    {
                        "name": "Calories",
                        "unit": "kcal",
                        "amount": 150,
                        "daily_value_percent": 8
                    }
                ],
                "serving_size": "1 cup (240mL)"
            },
            "unit_price": 0.03,
            "ingredients": "Whole Milk, Vitamin D3."
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or invalid, or an unknown parameter was sent. This response is not billable. |
| 404 | Not Found | No product with this id was found. This response is not billable. |
| 503 | Upstream Unavailable | H-E-B could not be reached after a fresh-exit retry. This response is not billable. |

## 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)
