Use Home Depot Search Results & Price Tracker with Python

Turn a Home Depot keyword search or search URL into structured product data: price, original price, brand, rating, reviews, and image, with sponsored-result and keyword filtering.

1. Choose the data you need

Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.

2. Prepare a source-based input

This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.

{
  "includeAisleBay": false,
  "includeDetails": false,
  "includeQuestions": false,
  "includeReviews": false,
  "includeSponsored": false,
  "includeStoreAvailability": false,
  "maxItems": 3,
  "maxItemsPerQuery": 3,
  "mode": "search",
  "onlyClearance": false,
  "onlyInStock": false,
  "onlyOnSale": false,
  "searchQueries": [
    "drill"
  ]
}

Download input.example.json and save your reviewed copy as input.json.

Field	Type	Required	Description
`mode`	string	required	Choose what to scrape: a keyword search, a category browse page, or specific Home Depot item IDs.
`searchQueries`	array	optional	One keyword per line, for example 'cordless drill'. Used in search mode.
`categoryUrls`	array	optional	Home Depot category URLs (/b/...) or browse codes (N-...). Used in category mode.
`itemIds`	array	optional	Home Depot item IDs or product URLs (/p/...). Used in products mode.
`storeId`	string	optional	Home Depot store number for store-local prices and pickup stock. 121 is Cumberland, GA.
`zipCode`	string	optional	Used to find the nearest store when Store ID is empty, and for delivery estimates.
`sortBy`	string	optional	How to order the products in each search or category.
`priceMin`	number	optional	Only keep products at or above this price.
`priceMax`	number	optional	Only keep products at or below this price.
`brand`	string	optional	Keep only products whose brand contains this text, for example Milwaukee.
`minRating`	number	optional	Drop products rated below this average, from 0 to 5.
`onlyOnSale`	boolean	optional	Keep only products with a real discount, promotion, special buy or clearance.
`onlyClearance`	boolean	optional	Keep only products with a clearance price.
`onlyInStock`	boolean	optional	Keep only products available for pickup at the selected store or for delivery.
`includeSponsored`	boolean	optional	Include paid product placements alongside organic results.
`filterKeywords`	string	optional	Comma-separated words; keep only products whose title contains at least one, for example chainsaw,chain saw.
`maxItems`	integer	optional	Overall maximum number of products to save.
`maxItemsPerQuery`	integer	optional	Maximum products to save from each search query or category.
`maxPages`	integer	optional	Maximum result pages to read for each search or category. Home Depot returns up to 24 products per page and 30 pages per browse.
`includeDetails`	boolean	optional	Add description, specs, key features, UPC/GTIN, all images, videos and variants for every product.
`includeReviews`	boolean	optional	Add customer reviews and the rating breakdown for every product.
`maxReviewsPerProduct`	integer	optional	Review cap for each product when reviews are enabled.
`reviewsSort`	string	optional	How to order reviews when reviews are enabled.
`includeQuestions`	boolean	optional	Add customer questions and their answers for every product.
`maxQuestionsPerProduct`	integer	optional	Question cap for each product when questions are enabled.
`includeStoreAvailability`	boolean	optional	Add store-local pickup quantity, pickup/delivery split and delivery details.
`includeAisleBay`	boolean	optional	Add the aisle and bay where the product sits at the selected store.

3. Start an Actor run

Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.

Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.

import json
import os
import urllib.request

# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
    actor_input = json.load(stream)

token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
    "https://api.apify.com/v2/acts/QFcedaopb4W0h72DA/runs?timeout=120&maxTotalChargeUsd=0.50",
    data=json.dumps(actor_input).encode("utf-8"),
    headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
    method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
    run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.

4. Inspect the actual results

Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.

Home Depot products with store-local price, pickup and delivery stock, specifications, media, variants, and optional reviews and Q&A.

Questions before you run

Which inputs are required?

The published required fields are mode

What does this guide verify?

The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.

What if the run request times out?

Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.

Open on Apify Full Actor reference

Generated from source build wuFfPsyQX2r5dL5kR and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.