Docs menu

Instacart API endpoint

Instacart stores API

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.

GETapiKey3 credits/requestInstacartinstacart.storesResponseDoc/instacart/stores

Endpoint facts

Method: GET
API path: /instacart/stores
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Instacart
Response schema: #/definitions/instacart.storesResponseDoc

Instacart Scraper API Try Instacart stores API in Playground Instacart API documentation

How this endpoint behaves

Query parameters:

postal_code (required) — US postal/ZIP code to search near.

Notable response behavior:

shop_id, store_slug (the store's slug field), and retailer_location_id from a result are the values GET /instacart/item and GET /instacart/search need.
Results cover every retailer partnered with Instacart in the area, not just grocery — warehouse clubs and specialty retailers are included.
accepts_ebt, saver_store, and delivery_eta are best-effort enrichment fetched after the base store list. A failure fetching either does not fail the request — those fields are simply omitted for the affected stores.

Live monitoring

Monitored request: GET /instacart/stores?postal_code=94105
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 6.51 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /instacart/stores?postal_code=94105
Items in stores: 136
Fields filled in every checked item: 8
Fields empty in some or all items: 2

Field	Filled in, of 136 checked	Values in the sample
shop_id	136
retailer_location_id	136
retailer_id	136
name	136	“Safeway” and 122 other values
slug	136
retailer_type	136	“Grocery - Traditional” and 31 other values
service_type	136	delivery (123), pickup (13)
logo_url	136	instacart.com
accepts_ebt	25	true in 25 of 25
delivery_eta	131	“25 min” and 19 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
postal_code	string	Yes		US postal/ZIP code to search near	94105
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/instacart/stores?postal_code=94105" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "postal_code": "94105",
    "stores": [
      {
        "shop_id": "9501",
        "retailer_location_id": "53",
        "retailer_id": "1",
        "name": "Safeway",
        "slug": "safeway",
        "retailer_type": "Grocery - Traditional",
        "service_type": "delivery",
        "logo_url": "https://www.instacart.com/assets/domains/warehouse/logo/1/3b7ef435-1d5a-463e-ae62-e4fa2aaab32b.png",
        "accepts_ebt": true,
        "delivery_eta": "By 4:45am"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/instacart.storesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	instacart.StoreSearchResponse	No
data.postal_code	string	No
data.stores	array	No
data.stores[].accepts_ebt	boolean	No		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.
data.stores[].delivery_eta	string	No
data.stores[].logo_url	string	No
data.stores[].name	string	No
data.stores[].retailer_id	string	No
data.stores[].retailer_location_id	string	No
data.stores[].retailer_type	string	No
data.stores[].saver_store	boolean	No
data.stores[].service_type	string	No
data.stores[].shop_id	string	No
data.stores[].slug	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/instacart/stores?postal_code=94105" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Instacart endpoint docs Instacart Scraper API Instacart departments API documentation Instacart item API documentation Instacart search nearby API documentation Instacart search API documentation Instacart trending API documentation

Open in Playground Back to group

Docs menu

Instacart API endpoint

Instacart stores API

GETapiKey3 credits/requestInstacartinstacart.storesResponseDoc/instacart/stores

Endpoint facts

Method: GET
API path: /instacart/stores
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Instacart
Response schema: #/definitions/instacart.storesResponseDoc

Instacart Scraper API Try Instacart stores API in Playground Instacart API documentation

How this endpoint behaves

Query parameters:

postal_code (required) — US postal/ZIP code to search near.

Notable response behavior:

shop_id, store_slug (the store's slug field), and retailer_location_id from a result are the values GET /instacart/item and GET /instacart/search need.
Results cover every retailer partnered with Instacart in the area, not just grocery — warehouse clubs and specialty retailers are included.
accepts_ebt, saver_store, and delivery_eta are best-effort enrichment fetched after the base store list. A failure fetching either does not fail the request — those fields are simply omitted for the affected stores.

Live monitoring

Monitored request: GET /instacart/stores?postal_code=94105
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 6.51 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /instacart/stores?postal_code=94105
Items in stores: 136
Fields filled in every checked item: 8
Fields empty in some or all items: 2

Field	Filled in, of 136 checked	Values in the sample
shop_id	136
retailer_location_id	136
retailer_id	136
name	136	“Safeway” and 122 other values
slug	136
retailer_type	136	“Grocery - Traditional” and 31 other values
service_type	136	delivery (123), pickup (13)
logo_url	136	instacart.com
accepts_ebt	25	true in 25 of 25
delivery_eta	131	“25 min” and 19 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
postal_code	string	Yes		US postal/ZIP code to search near	94105
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/instacart/stores?postal_code=94105" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "postal_code": "94105",
    "stores": [
      {
        "shop_id": "9501",
        "retailer_location_id": "53",
        "retailer_id": "1",
        "name": "Safeway",
        "slug": "safeway",
        "retailer_type": "Grocery - Traditional",
        "service_type": "delivery",
        "logo_url": "https://www.instacart.com/assets/domains/warehouse/logo/1/3b7ef435-1d5a-463e-ae62-e4fa2aaab32b.png",
        "accepts_ebt": true,
        "delivery_eta": "By 4:45am"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/instacart.storesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	instacart.StoreSearchResponse	No
data.postal_code	string	No
data.stores	array	No
data.stores[].accepts_ebt	boolean	No		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.
data.stores[].delivery_eta	string	No
data.stores[].logo_url	string	No
data.stores[].name	string	No
data.stores[].retailer_id	string	No
data.stores[].retailer_location_id	string	No
data.stores[].retailer_type	string	No
data.stores[].saver_store	boolean	No
data.stores[].service_type	string	No
data.stores[].shop_id	string	No
data.stores[].slug	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/instacart/stores?postal_code=94105" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Instacart stores API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Instacart stores API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related