The Home Depot

The Home Depot Canada price in Canadian dollars at a store you choose, the earlier price, and stock in the store and online, by item number, about 25 million item numbers per credit. Search with rating and review count.

Embed

<a href="https://scrapelyserp.com/docs/homedepot-products"><img src="https://scrapelyserp.com/docs/_api/public/orgs/affc5b0f-d3c2-423a-8143-9d10db5736ae/spaces/981e6275-da3f-446c-82de-889f59c83b6f/pages/ab4dcab2-b78b-469e-9f82-a0c1c6b6a2f5/social-card.svg?v=3e7ae33eec8b" alt="The Home Depot" width="600" height="315"></a>

At a glance

Property	Value
`platform`	`homedepot`
Item id	The 10 digits at the end of a Home Depot Canada product link, `https://www.homedepot.ca/product/ryobi-18v-one-cordless-1-2-in-drill-driver-kit-with-1-1-5-ah-battery-and-charger/1001686659` (`1001686659`). A pasted homedepot.ca product link is reduced to its item number. Search returns the same id.
Marketplaces	Live: `ca` (homedepot.ca, prices in CAD, the default). `us` is not available.
Tier	`standard` (the default), about 25 million item numbers per credit (an estimate until production traffic measures it)
Ids per call	400, all priced at the same store.
Store	`store` (a store number) or `postal_code` (a Canadian postal code: the nearest store), not both. Neither: store 7222 (Fort Saskatchewan, AB).
Typical call	1–5 s for 400 ids
Search	`GET /v1/structured/homedepot/search` by keyword, about 7.5 million results per credit.

Prices and stock are those of one store

Home Depot prices and stock per store. Every call is priced at one store, named in the response (store, and homedepot.store on each result): the one you send as store or postal_code, or the default. A store number that does not exist, or a postal code with no store near it, leaves every id unavailable with store null (only the small store check is charged); it is never a not_found.

A lookup has no title, rating or image

The item-number lookup returns price, earlier price, stock, aisle, bay and model. Title, brand, rating, review count, image and link come from search, whose result ids go straight into this endpoint.

Example

cURL
Python
Node.js

curl -X POST "https://api.scrapelyserp.com/v1/products" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "homedepot",
    "marketplace": "ca",
    "ids": [
      "1001686659",
      "https://www.homedepot.ca/product/dewalt-20v-max-atomic-lithium-ion-cordless-brushless-compact-1-2-inch-drill-driver-kit-with-2-0ah-battery-charger-bag/1001769719"
    ],
    "postal_code": "M5V 2T6"
  }'

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.post(
    "https://api.scrapelyserp.com/v1/products",
    headers=HEADERS,
    json={
        "platform": "homedepot",
        "marketplace": "ca",
        "ids": [
            "1001686659",
            "https://www.homedepot.ca/product/dewalt-20v-max-atomic-lithium-ion-cordless-brushless-compact-1-2-inch-drill-driver-kit-with-2-0ah-battery-charger-bag/1001769719",
        ],
        "postal_code": "M5V 2T6",
    },
    timeout=30,
)
r.raise_for_status()
data = r.json()
for p in data["results"]:
    print(p["id"], p["status"], (p.get("price") or {}).get("amount"), p["homedepot"]["stockAtStore"]["quantity"])

const res = await fetch('https://api.scrapelyserp.com/v1/products', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    platform: 'homedepot',
    marketplace: 'ca',
    ids: [
      '1001686659',
      'https://www.homedepot.ca/product/dewalt-20v-max-atomic-lithium-ion-cordless-brushless-compact-1-2-inch-drill-driver-kit-with-2-0ah-battery-charger-bag/1001769719',
    ],
    postal_code: 'M5V 2T6',
  }),
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();
for (const p of data.results) console.log(p.id, p.status, p.price?.amount, p.homedepot?.stockAtStore.quantity);

Full reference → POST /v1/products

Home Depot fields

Besides the common fields, each result carries a homedepot object.

Field	Description
`price`	The price in Canadian dollars at the store. `null` (and status `partial`) when Home Depot shows none; never 0.
`homedepot.originalPrice`, `savingsPercent`	The earlier (strike-through) price of a marked-down product and Home Depot's percentage off. `null` when there is no markdown.
`availability`	`inStock` is true when the product is in stock in the store or online, false when it is out in both, and absent when Home Depot gives neither.
`homedepot.stockAtStore`, `stockOnline`	`status` (`in_stock` or `out_of_stock`) and `quantity` (units Home Depot counts) in the store that was priced, and in the online pool. A product can be out in the store and in stock online. `null` when Home Depot gives none.
`homedepot.aisle`, `bay`, `model`	Where the product sits in the store, and the model number. `null` when absent.
`homedepot.store`	The store that was priced: `id`, `name`, `city`, `province`.
Not given	Title, brand, rating, review count, image and link (use search), and delivery promises.

Search results carry title, brand, rating and review count (Home Depot's own; null for a product with no reviews), image and link. A keyword Home Depot cannot match is not an empty list: it answers with one loosely matching product, total_results 1. The list is empty only when total_results is 0.

Statuses on Home Depot

partial: Home Depot has the item number but shows no price at this store. Try another store.
not_found: Home Depot has no such item number.
unavailable: no usable answer after retries, or the store could not be found. Ask again, or check the store.

Updated Nov 6, 2026

Was this page helpful?