---
type: "firecrawl-provider"
description: "Home Depot US and Canada product search, prices and stock, and US product details."
use_when: "Home Depot catalogue products, identified by Internet # (US) or product code (Canada)."
categories: "Retail"
capabilities: 2
pricing: "5 credits per billed unit; see each capability for its unit and maximum."
---
# Home Depot products on Firecrawl Alexandria

Home Depot US and Canada product search, prices and stock, and US product details.

- Categories: Retail
- Category index: [Retail category](https://alexandria.firecrawl.dev/agents/categories/retail)
- Provider key: `home-depot`
- Access: Firecrawl credits
- Cost (Search Home Depot products): 5 credits per call
- Cost (Get Home Depot product details): 5 credits per request

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/home-depot)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/home-depot/openapi.json)

## Capabilities

- [Search Home Depot products](https://alexandria.firecrawl.dev/agents/providers/home-depot/products/search): One page of Home Depot products, with the storefront page it reflects, result totals, the store used, available filters and links to further pages.
- [Get Home Depot product details](https://alexandria.firecrawl.dev/agents/providers/home-depot/products/lookup): One homedepot.com product, or found: false and product: null when the identifier matches nothing (not charged).

## 1. Choose this provider when

Home Depot catalogue products, identified by Internet # (US) or product code (Canada).

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "home-depot",
  "capability": "products/search",
  "options": {
    "query": "<query>",
    "country": "us",
    "page": 1
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `query` (string, required): Search text, as typed into the Home Depot search box. Example: `<query>`
- `country` (string): Storefront: us (homedepot.com, prices in USD) or ca (homedepot.ca, prices in CAD). Example: `us`
- `store_id` (string): Store number to read pickup and stock for, e.g. 2414 (US) or 7140 (Canada). Home Depot picks a default store when omitted. Example: `<store_id>`
- `delivery_zip` (string): Delivery area: a five-digit ZIP code for us, a postal code for ca. Example: `<delivery_zip>`
- `sort` (string): Order. top_sellers is US only. Example: `best_match`
- `min_price` (number): Lowest price, in the storefront's currency. Example: `10`
- `max_price` (number): Highest price, in the storefront's currency. Example: `10`
- `filters` (string): Filter tokens copied from the filters of an earlier search on the same storefront (comma-separated for us, dash-separated for ca). Example: `<filters>`
- `page` (number): Result page, from 1. Example: `1`
- `page_size` (number): Products per page: at most 24 for us (the default) and 40 for ca (the default). Home Depot may return fewer. Example: `10`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "home-depot",
    capability: "products/search",
    options: {
      query: "<query>",
      country: "us",
      page: 1,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "home-depot",
  "capability": "products/search",
  "options": {
    "query": "<query>",
    "country": "us",
    "page": 1
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "home-depot",
    "capability": "products/search",
    "options": {
      "query": "<query>",
      "country": "us",
      "page": 1
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'home-depot/products/search' \
  --options '{"query":"<query>","country":"us","page":1}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "home-depot",
  "capability": "products/search",
  "options": {
    "query": "<query>",
    "country": "us",
    "page": 1
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "home-depot",
  "capability": "products/search",
  "options": {
    "query": "<query>",
    "country": "us",
    "page": 1
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "products": [
    {
      "product_id": "<product_id>",
      "title": "<title>",
      "link": "<link>",
      "brand": "<brand>",
      "model_number": "<model_number>",
      "rating": 0,
      "reviews": 0,
      "price": 0,
      "currency": "<currency>",
      "price_was": 0,
      "price_saving": 0,
      "percentage_off": 0,
      "badges": [],
      "pickup": {},
      "delivery": {},
      "stock_information": {},
      "thumbnails": []
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Search Home Depot products

- Capability: `products/search`
- Description: One page of Home Depot products, with the storefront page it reflects, result totals, the store used, available filters and links to further pages.
- Instructions: Search Home Depot's US (homedepot.com) or Canadian (homedepot.ca) catalogue by keyword: product IDs, titles, brands, model numbers, ratings, current and was prices, and pickup, delivery and stock information for a store or delivery area. One page per call; pass page for the next one.
- Cost: 5 credits per call
- Capability file: [Search Home Depot products](https://alexandria.firecrawl.dev/agents/providers/home-depot/products/search)

Accepted options:
- `query` (string, required): Search text, as typed into the Home Depot search box. Example: `<query>`
- `country` (string): Storefront: us (homedepot.com, prices in USD) or ca (homedepot.ca, prices in CAD). Example: `us`
- `store_id` (string): Store number to read pickup and stock for, e.g. 2414 (US) or 7140 (Canada). Home Depot picks a default store when omitted. Example: `<store_id>`
- `delivery_zip` (string): Delivery area: a five-digit ZIP code for us, a postal code for ca. Example: `<delivery_zip>`
- `sort` (string): Order. top_sellers is US only. Example: `best_match`
- `min_price` (number): Lowest price, in the storefront's currency. Example: `10`
- `max_price` (number): Highest price, in the storefront's currency. Example: `10`
- `filters` (string): Filter tokens copied from the filters of an earlier search on the same storefront (comma-separated for us, dash-separated for ca). Example: `<filters>`
- `page` (number): Result page, from 1. Example: `1`
- `page_size` (number): Products per page: at most 24 for us (the default) and 40 for ca (the default). Home Depot may return fewer. Example: `10`

Response schema example:
```json
{
  "products": [
    {
      "product_id": "<product_id>",
      "title": "<title>",
      "link": "<link>",
      "brand": "<brand>",
      "model_number": "<model_number>",
      "rating": 0,
      "reviews": 0,
      "price": 0,
      "currency": "<currency>",
      "price_was": 0,
      "price_saving": 0,
      "percentage_off": 0,
      "badges": [],
      "pickup": {},
      "delivery": {},
      "stock_information": {},
      "thumbnails": []
    }
  ]
}
```

### Get Home Depot product details

- Capability: `products/lookup`
- Description: One homedepot.com product, or found: false and product: null when the identifier matches nothing (not charged).
- Instructions: Get one homedepot.com product's details from its Internet #, Store SKU or product page URL: description, price, UPC, model and store SKU numbers, brand, images, specifications, ratings and pickup or delivery fulfilment for a store or ZIP code. US products only; for homedepot.ca use products/search.
- Cost: 5 credits per request
- Capability file: [Get Home Depot product details](https://alexandria.firecrawl.dev/agents/providers/home-depot/products/lookup)

Accepted options:
- `product_id` (string): The 9-10 digit Internet # from a homedepot.com product page. Example: `<product_id>`
- `store_sku` (string): The Store SKU # from a homedepot.com product page. A SKU can match more than one product. Example: `<store_sku>`
- `url` (string): A homedepot.com product page URL, e.g. https://www.homedepot.com/p/.../344978534. Example: `<url>`
- `store_id` (string): Store number to read pickup and stock for, e.g. 2414. Example: `<store_id>`
- `delivery_zip` (string): Five-digit US ZIP code for delivery options. Example: `<delivery_zip>`

Response schema example:
```json
{
  "product": {
    "product_id": "<product_id>",
    "title": "<title>",
    "description": "<description>",
    "link": "<link>",
    "upc": "<upc>",
    "model_number": "<model_number>",
    "store_sku_number": "<store_sku_number>",
    "brand": {},
    "price": 0,
    "rating": 0,
    "reviews": 0,
    "highlights": [],
    "images": [],
    "specifications": [],
    "fulfillment": {}
  }
}
```
