Docs menu

Instacart API endpoint

Instacart departments API

Returns a store's department/category taxonomy (Produce, Dairy & Eggs, Bakery, ...) two levels deep -- department and subcategory. Metadata only, does not return products. Public data sourced from Instacart's own storefront navigation.

GETapiKey3 credits/requestInstacartinstacart.departmentsResponseDoc/instacart/departments

Endpoint facts

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

Instacart Scraper API Try Instacart departments API in Playground Instacart API documentation

How this endpoint behaves

Query parameters:

shop_id (required) — store's opaque shop id, from GET /instacart/stores.
store_slug (required) — store's retailer slug, from GET /instacart/stores.
postal_code (required) — postal code to localize the taxonomy for.

Notable response behavior:

The taxonomy may include a small number of non-food, promotional or internal groupings alongside real departments (e.g. an "Evergreen VC" entry seen live) — these are passed through as returned rather than filtered, since there is no reliable documented signal to distinguish them from real departments.
This endpoint returns the taxonomy only, not products within a department.

Live monitoring

Monitored request: GET /instacart/departments?postal_code=94105&shop_id=9501&store_slug=safeway
Checks passed, 7 days to 14 Oct 2026: 99.7%
Median response time: 5.63 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /instacart/departments?postal_code=94105&shop_id=9501&store_slug=safeway
Items in departments: 35
Fields filled in every checked item: 4

Field	Filled in, of 35 checked	Values in the sample
id	35
name	35	“Sip Vibe” and 34 other values
slug	35
subcategories	35	median 9 entries

Request parameters

Parameter	Type	Required	Description	Example
shop_id	string	Yes	Store's opaque shop id, from GET /instacart/stores	9501
store_slug	string	Yes	Store's retailer slug, from GET /instacart/stores	safeway
postal_code	string	Yes	Postal code to localize the taxonomy for	94105
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/instacart/departments?shop_id=9501&store_slug=safeway&postal_code=94105" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "shop_id": "9501",
    "departments": [
      {
        "id": "88",
        "name": "Produce",
        "slug": "produce",
        "subcategories": [
          {
            "id": "79",
            "name": "Fresh Fruits",
            "slug": "fresh-fruits"
          },
          {
            "id": "80",
            "name": "Fresh Vegetables",
            "slug": "fresh-vegetables"
          },
          {
            "id": "78",
            "name": "Herbs",
            "slug": "herbs"
          }
        ]
      },
      {
        "id": "98",
        "name": "Dairy & Eggs",
        "slug": "dairy",
        "subcategories": [
          {
            "id": "85",
            "name": "Milk",
            "slug": "milk"
          },
          {
            "id": "106",
            "name": "Cheese",
            "slug": "cheese"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/instacart.departmentsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	instacart.DepartmentsResponse	No
data.departments	array	No
data.departments[].id	string	No
data.departments[].name	string	No
data.departments[].slug	string	No
data.departments[].subcategories	array	No
data.departments[].subcategories[].id	string	No
data.departments[].subcategories[].name	string	No
data.departments[].subcategories[].slug	string	No
data.shop_id	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/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/departments?shop_id=9501&store_slug=safeway&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 item API documentation Instacart search nearby API documentation Instacart search API documentation Instacart stores API documentation Instacart trending API documentation

Open in Playground Back to group

Docs menu

Instacart API endpoint

Instacart departments API

GETapiKey3 credits/requestInstacartinstacart.departmentsResponseDoc/instacart/departments

Endpoint facts

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

Instacart Scraper API Try Instacart departments API in Playground Instacart API documentation

How this endpoint behaves

Query parameters:

shop_id (required) — store's opaque shop id, from GET /instacart/stores.
store_slug (required) — store's retailer slug, from GET /instacart/stores.
postal_code (required) — postal code to localize the taxonomy for.

Notable response behavior:

The taxonomy may include a small number of non-food, promotional or internal groupings alongside real departments (e.g. an "Evergreen VC" entry seen live) — these are passed through as returned rather than filtered, since there is no reliable documented signal to distinguish them from real departments.
This endpoint returns the taxonomy only, not products within a department.

Live monitoring

Monitored request: GET /instacart/departments?postal_code=94105&shop_id=9501&store_slug=safeway
Checks passed, 7 days to 14 Oct 2026: 99.7%
Median response time: 5.63 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /instacart/departments?postal_code=94105&shop_id=9501&store_slug=safeway
Items in departments: 35
Fields filled in every checked item: 4

Field	Filled in, of 35 checked	Values in the sample
id	35
name	35	“Sip Vibe” and 34 other values
slug	35
subcategories	35	median 9 entries

Request parameters

Parameter	Type	Required	Description	Example
shop_id	string	Yes	Store's opaque shop id, from GET /instacart/stores	9501
store_slug	string	Yes	Store's retailer slug, from GET /instacart/stores	safeway
postal_code	string	Yes	Postal code to localize the taxonomy for	94105
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/instacart/departments?shop_id=9501&store_slug=safeway&postal_code=94105" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "shop_id": "9501",
    "departments": [
      {
        "id": "88",
        "name": "Produce",
        "slug": "produce",
        "subcategories": [
          {
            "id": "79",
            "name": "Fresh Fruits",
            "slug": "fresh-fruits"
          },
          {
            "id": "80",
            "name": "Fresh Vegetables",
            "slug": "fresh-vegetables"
          },
          {
            "id": "78",
            "name": "Herbs",
            "slug": "herbs"
          }
        ]
      },
      {
        "id": "98",
        "name": "Dairy & Eggs",
        "slug": "dairy",
        "subcategories": [
          {
            "id": "85",
            "name": "Milk",
            "slug": "milk"
          },
          {
            "id": "106",
            "name": "Cheese",
            "slug": "cheese"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/instacart.departmentsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	instacart.DepartmentsResponse	No
data.departments	array	No
data.departments[].id	string	No
data.departments[].name	string	No
data.departments[].slug	string	No
data.departments[].subcategories	array	No
data.departments[].subcategories[].id	string	No
data.departments[].subcategories[].name	string	No
data.departments[].subcategories[].slug	string	No
data.shop_id	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/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/departments?shop_id=9501&store_slug=safeway&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 departments 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 departments 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