---
title: "Find Instacart stores near a postal code"
method: GET
path: "/instacart/stores"
tags: ["Instacart"]
---

# Find Instacart stores near a postal code

`GET /instacart/stores`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/instacart/stores`
- Auth: API key in header `x-api-key`

Finds Instacart retailer storefronts (grocery stores, warehouse clubs, and other partner retailers) serving a US postal code, each with the identifiers needed to look up its items and search suggestions. Public data sourced from Instacart's own store-discovery API.

## Query parameters

- `postal_code` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- InstacartStoresResponseDoc
  - `code` integer
  - `data` InstacartStoreSearchResponse
    - `postal_code` string
    - `stores` InstacartStore[]
      - `accepts_ebt` boolean: AcceptsEBT, SaverStore, and DeliveryETA are best-effort enrichment: separate upstream calls (ShopTags, GetAccurateVisitorRetailerEtas) made after the base store list, matched back by shop/retailer id. A failure fetching either leaves these fields at their zero value rather than failing the whole Stores response -- see Service.Stores.
      - `delivery_eta` string
      - `logo_url` string
      - `name` string
      - `retailer_id` string
      - `retailer_location_id` string
      - `retailer_type` string
      - `saver_store` boolean
      - `service_type` string
      - `shop_id` string
      - `slug` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)
