# Lowes API

> Lowe's departments, category products, product details and variants (unverified)

- Vendor: `lowesapi` · version 1.0 · category E-commerce · tags lowes api, lowes product api, lowes prices api, home improvement api, lowes categories api, hardware store data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/lowesapi
- This document: https://apiclay.com/docs/lowesapi.md
- OpenAPI 3.1: https://apiclay.com/api/lowesapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `lowesapi`
- Updated: 2026-11-18

## About

## Lowe's API

Lowe's department menu and category tree, category product listings, and product details with store price, inventory and variants.

Data comes from **lowes.com** (https://www.lowes.com). Every route below calls the site's own endpoint directly and returns the upstream response unchanged.

Typical flow: `/menus` -&gt; `/categories` -&gt; `/products` -&gt; `/product` -&gt; `/variants`

Stores are Lowe's store numbers. Routes that take a `Cookie` header read the store from `sn=`; send `dbidv2=; sn=`.

### Routes

#### GET `/menus` - Menus (department menu)
The site's "Shop" flyout menu content for a store.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| targetMap | query | string | yes | `{'storeId': '', 'audienceList': []}` (this exact form). |

Returns (fields the source code reads; not yet verified live):
- `contents[0].instance.items[0].props.widgetKey[]`: menu nodes with `id`, `name`, `value` (URL), `children` (ids); departments are the children of the node named `shop`

#### GET `/categories` - Categories (department menu tree)
The same menu content as `/menus`; walk a department's `children` down to the leaves.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| targetMap | query | string | yes | `{'storeId': '', 'audienceList': []}`. |

Returns (fields the source code reads; not yet verified live):
- `...widgetKey[]`: leaf nodes whose `value` is a category URL `/pl//` (used by `/products`)

#### GET `/products` - Products (category listing)
One page (24) of a category's products.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| slug | path | string | yes | Category slug from the category URL, e.g. `Smart-compatible--Garage-door-openers-Garage-doors-openers-Windows-doors`. |
| category_id | path | string | yes | Category id from the category URL, e.g. `4294858020`. |
| offset | query | string | no | `0`, `24`, `48`, ... (up to 25 pages). |
| Cookie | header | string | no | `dbidv2=; sn=` for store prices. |

Returns (fields the source code reads; not yet verified live):
- `itemCount`: number of products
- `itemList[]`: products with id, description, brand, price and image

#### GET `/product` - Product (product details)
One product at a store: price, images, pickup and delivery availability.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| product_id | path | string | yes | Product id (last part of the product URL). |
| store_id | path | string | yes | Store number. |
| Cookie | header | string | no | `dbidv2=; sn=`. |

Returns (fields the source code reads; not yet verified live):
- `productId`; `productDetails..product.omniItemId`, `product.imageUrls[]`
- `productDetails..location.itemInventory.itemAvailList[]`: `fullMtdMsg` (Pickup, Delivery, ...) and `isAvlSts`
- `productDetails.` price fields

#### GET `/variants` - Variants (product details with variants, web)
The product details call with zip code; includes the variant selector data.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| product_id | path | string | yes | Product id. |
| store_id | path | string | yes | Store number. |
| zip | path | string | yes | Zip code. |
| nearByStore | query | string | yes | Store number. |
| zipState | query | string | yes | State code, e.g. `NC`. |
| Cookie | header | string | no | `dbidv2=; sn=`. |

Returns (fields the source code reads; not yet verified live):
- `productDetails..product.productVariantsV3.variantUIData[]`: variant options and their item ids

### Not yet available

| Endpoint | Why |
|---|---|
| variants (mobile app API) | needs an app OAuth token from a separate token call first (two-step) |

### Caveats

- These routes were written from MealMe's source code and have not been tested live yet (the site blocks plain requests from the test machine).
- The source site uses bot protection (Akamai); calls may be blocked until that is handled.
- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- Not affiliated with lowes.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /menus — Menus (department menu)
- Gateway: `GET https://api.apiclay.com/v1/api/lowesapi/menus`
- Public query params: `targetMap` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories (department menu tree)
- Gateway: `GET https://api.apiclay.com/v1/api/lowesapi/categories`
- Public query params: `targetMap` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /products — Products (category listing)
- Gateway: `GET https://api.apiclay.com/v1/api/lowesapi/products`
- Public headers: `Cookie`
- Public query params: `offset` (string), `slug` (string, required), `category_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /product — Product (product details)
- Gateway: `GET https://api.apiclay.com/v1/api/lowesapi/product`
- Public headers: `Cookie`
- Public query params: `product_id` (string, required), `store_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /variants — Variants (product details with variants, web)
- Gateway: `GET https://api.apiclay.com/v1/api/lowesapi/variants`
- Public headers: `Cookie`
- Public query params: `nearByStore` (string, required), `zipState` (string, required), `product_id` (string, required), `store_id` (string, required), `zip` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/lowesapi/menus?targetMap=<targetMap>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
