# Lowes — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse products from Lowe's, including product listings by category, detailed product information, and pricing. Retrieve comprehensive details on specific items to compare options and make informed purchasing decisions.

**Category:** E-commerce | **Website:** [www.lowes.com/](https://www.lowes.com/) | **Docs:** [parse.bot/marketplace/f059f07d-30be-4345-950c-8231c4b068ab/lowes-com-api](https://parse.bot/marketplace/f059f07d-30be-4345-950c-8231c4b068ab/lowes-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/lowes/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get category products

Get product listings for a given category with prices, specs, and availability. Supports named lumber categories (dimensional-lumber, studs, pressure-treated-lumber, plywood, boards, deck-boards) or numeric category IDs. Returns results ordered by relevance. Each product includes specs, ratings, and inventory status for the specified store. Paginate manually via offset parameter; next_offset in response indicates the next page offset or null when exhausted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category name or numeric category ID. Named categories: dimensional-lumber, studs, pressure-treated-lumber, plywood, boards, deck-boards. |
| `limit` | integer | No | Maximum number of products to return per request. |
| `offset` | integer | No | Pagination offset (number of items to skip). |
| `store_number` | string | No | Lowe's store number for local pricing and inventory. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/lowes/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","offset":"<integer>","store_number":"<string>"}'
```

### Get product detail

Get comprehensive product details including pricing, availability by fulfillment method, promotions, and specifications. Attempts the product detail API first, then falls back to the SSR product page. Returns enriched data beyond what list/search endpoints provide, including barcode, additional images, pricing breakdowns, and per-fulfillment-method availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Lowe's product ID (omniItemId), e.g. '4082896'. |
| `store_number` | string | No | Store number for local pricing and inventory. |
| `zip_code` | string | No | ZIP code for delivery availability. |
| `zip_state` | string | No | Two-letter state code corresponding to zip_code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/lowes/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","store_number":"<string>","zip_code":"<string>","zip_state":"<string>"}'
```

### Search products

Search for products by keyword. Returns results with product details, pricing, and availability. Server-side search matches product descriptions and titles. Results ordered by relevance. Paginate manually via offset parameter; next_offset in response indicates the next page offset or null when exhausted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum products to return. |
| `offset` | integer | No | Pagination offset (number of items to skip). |
| `query` | string | No | Search keyword. |
| `store_number` | string | No | Lowe's store number for local pricing. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/lowes/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","store_number":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.