# Instacart Stores API Documentation

<p><strong>Instacart Stores API</strong> lists grocery retailers available at a US ZIP. Each store has its shop id, retailer id, slug, name, categories, logo and delivery ETA when the source publishes one.</p><p>Send a five-digit <code>zip</code> from the supported set (currently 10016). Other ZIPs answer 422 without an upstream call. The source market must be a real US city and state for that ZIP. Costs 1 credit per successful request with results. Failed requests and empty results are free.</p>

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

## 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 |
| --- | --- | --- | --- |
| `zip` | string | Yes | Required supported US ZIP (currently 10016); other ZIPs answer 422; validity gate only, not echoed back |

## Example response

```json
{
    "data": {
        "count": 2,
        "market": {
            "city": "New York",
            "state": "NY",
            "postal_code": "10016"
        },
        "stores": [
            {
                "logo": "https://example.invalid/logo.png",
                "name": "Safeway",
                "slug": "safeway",
                "shop_id": "37447",
                "categories": [
                    "Grocery"
                ],
                "retailer_id": 118,
                "delivery_eta": {
                    "eta_seconds": 3600,
                    "delivery_string": "Delivery in 1 hour"
                }
            }
        ],
        "requested_zip": "10016"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "stores"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Market Mismatch | The egress market does not match the requested ZIP. No data was labelled with that ZIP. This response is not billable. |
| 422 | Validation Error | The ZIP is missing or invalid. 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)
