# Home Depot — 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 Home Depot's product catalog to compare pricing, check real-time availability, and review detailed product specifications. Find products across all categories, look up store locations and hours, and check fulfillment options including in-store pickup and delivery.

**Category:** E-commerce | **Website:** [homedepot.com/](https://homedepot.com/) | **Docs:** [parse.bot/marketplace/82fe49d4-28c1-4500-869d-712605e13cf5/homedepot-com-api](https://parse.bot/marketplace/82fe49d4-28c1-4500-869d-712605e13cf5/homedepot-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/home-depot/`
**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

### Find stores

Locate a Home Depot store using a ZIP code. Returns the nearest store with address, hours, services, and contact information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | Yes | 5-digit US ZIP code (e.g. '30339') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/home-depot/find-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"zip_code":"<string>"}'
```

### Get product availability

Get availability, pricing, and in-store pickup status for a product. Returns availability type (whether the product is buyable, discontinued), pricing, and pickup inventory at the specified store. Fetches the product detail page and then queries the fulfillment GraphQL endpoint for pickup data when a store_id is provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Product itemId (e.g. '326680222') |
| `store_id` | string | No | Store ID to check availability and pickup inventory at |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/home-depot/get-product-availability \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","store_id":"<string>"}'
```

### Get product details

Get comprehensive product details including description, highlights, media, pricing, and availability type for a given item ID. Fetches the product detail page and extracts structured data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The product itemId (internet number), e.g. '326680222' |
| `store_id` | string | No | Store ID for local pricing |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/home-depot/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>","store_id":"<string>"}'
```

### Get store details

Retrieve details for a specific Home Depot store by store ID. Returns store name, address, hours, services, and contact information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_id` | string | Yes | Store ID (e.g. '6932') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/home-depot/get-store-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"store_id":"<string>"}'
```

### Search products

Search for products by keyword on Home Depot. Returns a list of products with identifiers, media, pricing, and in-store pickup availability. When store_id is provided, each product includes pickup data (quantity available and status). Results are limited to the first page (up to 24 by default). Each product with a store_id triggers a separate fulfillment lookup, so response time scales with the number of returned products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max products to return (applied client-side to trim results) |
| `query` | string | Yes | Search term (e.g. 'drill', 'hammer', 'power tools') |
| `store_id` | string | No | Store ID for local pricing and in-store pickup availability |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/home-depot/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","store_id":"<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.