Dataspryva
Actors/Home Depot Search Results & Price Tracker

Home Depot Search Results & Price Tracker

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.

Open on ApifyGitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
modestringrequiredChoose what to scrape: a keyword search, a category browse page, or specific Home Depot item IDs.
searchQueriesarrayoptionalOne keyword per line, for example 'cordless drill'. Used in search mode.
categoryUrlsarrayoptionalHome Depot category URLs (/b/...) or browse codes (N-...). Used in category mode.
Show all input fields
FieldTypeRequiredDescription
modestringrequiredChoose what to scrape: a keyword search, a category browse page, or specific Home Depot item IDs.
searchQueriesarrayoptionalOne keyword per line, for example 'cordless drill'. Used in search mode.
categoryUrlsarrayoptionalHome Depot category URLs (/b/...) or browse codes (N-...). Used in category mode.
itemIdsarrayoptionalHome Depot item IDs or product URLs (/p/...). Used in products mode.
storeIdstringoptionalHome Depot store number for store-local prices and pickup stock. 121 is Cumberland, GA.
zipCodestringoptionalUsed to find the nearest store when Store ID is empty, and for delivery estimates.
sortBystringoptionalHow to order the products in each search or category.
priceMinnumberoptionalOnly keep products at or above this price.
priceMaxnumberoptionalOnly keep products at or below this price.
brandstringoptionalKeep only products whose brand contains this text, for example Milwaukee.
minRatingnumberoptionalDrop products rated below this average, from 0 to 5.
onlyOnSalebooleanoptionalKeep only products with a real discount, promotion, special buy or clearance.
onlyClearancebooleanoptionalKeep only products with a clearance price.
onlyInStockbooleanoptionalKeep only products available for pickup at the selected store or for delivery.
includeSponsoredbooleanoptionalInclude paid product placements alongside organic results.
filterKeywordsstringoptionalComma-separated words; keep only products whose title contains at least one, for example chainsaw,chain saw.
maxItemsintegeroptionalOverall maximum number of products to save.
maxItemsPerQueryintegeroptionalMaximum products to save from each search query or category.
maxPagesintegeroptionalMaximum result pages to read for each search or category. Home Depot returns up to 24 products per page and 30 pages per browse.
includeDetailsbooleanoptionalAdd description, specs, key features, UPC/GTIN, all images, videos and variants for every product.
includeReviewsbooleanoptionalAdd customer reviews and the rating breakdown for every product.
maxReviewsPerProductintegeroptionalReview cap for each product when reviews are enabled.
reviewsSortstringoptionalHow to order reviews when reviews are enabled.
includeQuestionsbooleanoptionalAdd customer questions and their answers for every product.
maxQuestionsPerProductintegeroptionalQuestion cap for each product when questions are enabled.
includeStoreAvailabilitybooleanoptionalAdd store-local pickup quantity, pickup/delivery split and delivery details.
includeAisleBaybooleanoptionalAdd the aisle and bay where the product sits at the selected store.

Download the published input schema

View complete JSON
{
  "properties": {
    "brand": {
      "description": "Keep only products whose brand contains this text, for example Milwaukee.",
      "editor": "textfield",
      "title": "Brand (optional)",
      "type": "string"
    },
    "categoryUrls": {
      "description": "Home Depot category URLs (/b/...) or browse codes (N-...). Used in category mode.",
      "editor": "stringList",
      "title": "Category URLs or Browse Codes",
      "type": "array"
    },
    "filterKeywords": {
      "description": "Comma-separated words; keep only products whose title contains at least one, for example chainsaw,chain saw.",
      "editor": "textfield",
      "title": "Title Keywords (optional)",
      "type": "string"
    },
    "includeAisleBay": {
      "default": false,
      "description": "Add the aisle and bay where the product sits at the selected store.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include Aisle and Bay",
      "type": "boolean"
    },
    "includeDetails": {
      "default": true,
      "description": "Add description, specs, key features, UPC/GTIN, all images, videos and variants for every product.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include Product Details",
      "type": "boolean"
    },
    "includeQuestions": {
      "default": false,
      "description": "Add customer questions and their answers for every product.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include Questions & Answers",
      "type": "boolean"
    },
    "includeReviews": {
      "default": false,
      "description": "Add customer reviews and the rating breakdown for every product.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include Reviews",
      "type": "boolean"
    },
    "includeSponsored": {
      "default": false,
      "description": "Include paid product placements alongside organic results.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include Sponsored Products",
      "type": "boolean"
    },
    "includeStoreAvailability": {
      "default": true,
      "description": "Add store-local pickup quantity, pickup/delivery split and delivery details.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include Store Availability",
      "type": "boolean"
    },
    "itemIds": {
      "description": "Home Depot item IDs or product URLs (/p/...). Used in products mode.",
      "editor": "stringList",
      "title": "Item IDs or Product URLs",
      "type": "array"
    },
    "maxItems": {
      "default": 100,
      "description": "Overall maximum number of products to save.",
      "editor": "number",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum Products",
      "type": "integer"
    },
    "maxItemsPerQuery": {
      "default": 100,
      "description": "Maximum products to save from each search query or category.",
      "editor": "number",
      "maximum": 1000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum Products Per Query or Category",
      "type": "integer"
    },
    "maxPages": {
      "default": 30,
      "description": "Maximum result pages to read for each search or category. Home Depot returns up to 24 products per page and 30 pages per browse.",
      "editor": "number",
      "maximum": 30,
      "minimum": 1,
      "title": "Maximum Pages Per Source",
      "type": "integer"
    },
    "maxQuestionsPerProduct": {
      "default": 10,
      "description": "Question cap for each product when questions are enabled.",
      "editor": "number",
      "maximum": 50,
      "minimum": 0,
      "title": "Maximum Questions Per Product",
      "type": "integer"
    },
    "maxReviewsPerProduct": {
      "default": 20,
      "description": "Review cap for each product when reviews are enabled.",
      "editor": "number",
      "maximum": 100,
      "minimum": 0,
      "title": "Maximum Reviews Per Product",
      "type": "integer"
    },
    "minRating": {
      "description": "Drop products rated below this average, from 0 to 5.",
      "editor": "number",
      "maximum": 5,
      "minimum": 0,
      "title": "Minimum Rating",
      "type": "number"
    },
    "mode": {
      "default": "search",
      "description": "Choose what to scrape: a keyword search, a category browse page, or specific Home Depot item IDs.",
      "editor": "select",
      "enum": [
        "search",
        "category",
        "products"
      ],
      "enumTitles": [
        "Search by keyword",
        "Browse a category",
        "Look up item IDs"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "onlyClearance": {
      "default": false,
      "description": "Keep only products with a clearance price.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Only Clearance Products",
      "type": "boolean"
    },
    "onlyInStock": {
      "default": false,
      "description": "Keep only products available for pickup at the selected store or for delivery.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Only Products In Stock",
      "type": "boolean"
    },
    "onlyOnSale": {
      "default": false,
      "description": "Keep only products with a real discount, promotion, special buy or clearance.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Only Products On Sale",
      "type": "boolean"
    },
    "priceMax": {
      "description": "Only keep products at or below this price.",
      "editor": "number",
      "minimum": 0,
      "title": "Maximum Price (USD)",
      "type": "number"
    },
    "priceMin": {
      "description": "Only keep products at or above this price.",
      "editor": "number",
      "minimum": 0,
      "title": "Minimum Price (USD)",
      "type": "number"
    },
    "reviewsSort": {
      "default": "most_recent",
      "description": "How to order reviews when reviews are enabled.",
      "editor": "select",
      "enum": [
        "most_recent",
        "most_helpful",
        "oldest",
        "highest_rating",
        "lowest_rating",
        "photos_first"
      ],
      "enumTitles": [
        "Most recent",
        "Most helpful",
        "Oldest",
        "Highest rating",
        "Lowest rating",
        "Photos first"
      ],
      "title": "Review Order",
      "type": "string"
    },
    "searchQueries": {
      "description": "One keyword per line, for example 'cordless drill'. Used in search mode.",
      "editor": "stringList",
      "prefill": [
        "drill"
      ],
      "title": "Search Queries",
      "type": "array"
    },
    "sortBy": {
      "default": "relevance",
      "description": "How to order the products in each search or category.",
      "editor": "select",
      "enum": [
        "relevance",
        "top_sellers",
        "price_low_to_high",
        "price_high_to_low",
        "top_rated",
        "newest"
      ],
      "enumTitles": [
        "Relevance",
        "Top Sellers",
        "Price: Low to High",
        "Price: High to Low",
        "Top Rated",
        "Newest"
      ],
      "title": "Sort Order",
      "type": "string"
    },
    "storeId": {
      "default": "121",
      "description": "Home Depot store number for store-local prices and pickup stock. 121 is Cumberland, GA.",
      "editor": "textfield",
      "title": "Store ID",
      "type": "string"
    },
    "zipCode": {
      "description": "Used to find the nearest store when Store ID is empty, and for delivery estimates.",
      "editor": "textfield",
      "title": "ZIP Code (optional)",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Home Depot Products, Prices & Store Stock Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

FieldTypeRequiredDescription
productsstringoptionalDataset containing all scraped Home Depot product records.

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "description": "Home Depot products with store-local price, pickup and delivery stock, specifications, media, variants, and optional reviews and Q&A.",
  "properties": {
    "products": {
      "description": "Dataset containing all scraped Home Depot product records.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Home Depot products",
      "type": "string"
    }
  },
  "title": "Home Depot Products, Prices & Store Stock Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

This definition is not present in the default published build. See the published README for available documentation.

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Home Depot Products, Prices & Store Stock

Scrape Home Depot products from a keyword search, a category page or a list of item IDs. Every row can include the store-local price, pickup and delivery availability, aisle and bay, full specifications, media, variants, and optional reviews and Q&A.

What this actor does

  • Three ways to start — search by keyword, browse a whole category, or look up specific item IDs and product URLs.
  • Store-local pricing and stock — pick a Home Depot store (or a ZIP to find the nearest one) and read that store's price and shelf pickup quantity.
  • Pickup and delivery kept separate — shelf pickup quantity, ship-to-store availability, and online/delivery quantity are separate fields and are never mixed.
  • Full product detail — description, highlights, specification groups, key features, dimensions, UPC/GTIN, all images, videos, 360/AR links, bundle contents and variant swatches.
  • Optional reviews and Q&A — add a capped set of customer reviews with rating breakdown, and customer questions with their answers.
  • Filters and pagination — price, brand, rating, sale, clearance, stock, sponsored and title filters, plus multi-page collection with duplicate removal.
  • Empty fields are omitted from each record instead of being returned as null or blank.

Output per product

Identity — recordType, itemId, parentId, url, title, brand, modelNumber, storeSku, productType, upc, gtin13, brandUrl, collection, scrapedAt

Pricing — price, originalPrice, currency, discountAmount, discountPercent, unitOfMeasure, unitPrice, bulkPrice, clearancePrice, isSpecialBuy, isClearance, onPromotion, promotionTag, savingsCenter, promotionStartsAt, promotionEndsAt, conditionalPromotions

Ratings and reviews — rating, reviewCount, ratingDistribution, recommendedCount, notRecommendedCount, reviews[] with text, author, date, verified purchase, photos, responses, and source

Media and content — imageUrl, images[], videos[], threeSixty, augmentedReality, description, highlights[], specifications[], keyFeatures[], dimensions[], isBundle, bundleItems[], subscription, installation, prop65, protectionPlanSkus[]

Variants and taxonomy — hasVariants, variantCount, variants[], categories[], breadcrumbs[], department, badges[], isSponsored

Store and fulfillment — storeId, storeName, storeCity, storeState, storePostalCode, storePhone, pickupAvailable, storeQuantity, pickupInStock, pickupLimited, curbsidePickup, pickupMaxQuantity, shipToStoreAvailable, deliveryAvailable, deliveryQuantity, deliveryEta, deliveryCharge, freeShipping, backordered, backorderDate, pickupOptions[], deliveryOptions[], aisle, bay, aisleBay, quantityLimit, returnPolicy, isBuyable, discontinued

Questions — questions[] with the question, author, date, answers and photos

Input

Field Type Default Description
mode select search search, category, or products
searchQueries list – Keywords for search mode, one per line
categoryUrls list – Category /b/... URLs or browse codes (N-...)
itemIds list – Item IDs or /p/... product URLs
storeId string 121 Store number for price and shelf stock
zipCode string – Finds the nearest store when storeId is empty; also used for delivery estimates
sortBy select relevance relevance, top_sellers, price_low_to_high, price_high_to_low, top_rated, newest
priceMin / priceMax number – USD price bounds
brand string – Case-insensitive brand filter
minRating number – Drop products rated below this value (0–5)
onlyOnSale boolean false Keep real discounts, promotions, special buys and clearance
onlyClearance boolean false Keep clearance products only
onlyInStock boolean false Keep products available for pickup or delivery
includeSponsored boolean false Include paid placements
filterKeywords string – Comma-separated title words to keep
maxItems integer 100 Overall product cap (1–5000)
maxItemsPerQuery integer 100 Cap per query or category
maxPages integer 30 Pages per source (1–30; 24 products per page)
includeDetails boolean true Add specs, description, UPC/GTIN, media and variants
includeReviews boolean false Add reviews and rating breakdown
maxReviewsPerProduct integer 20 Review cap per product
reviewsSort select most_recent most_recent, most_helpful, oldest, highest_rating, lowest_rating, photos_first
includeQuestions boolean false Add customer questions and answers
maxQuestionsPerProduct integer 10 Question cap per product
includeStoreAvailability boolean true Add pickup/delivery stock fields
includeAisleBay boolean false Add aisle and bay for in-store SKUs

Legacy inputs from earlier versions (searchQuery, startUrls) continue to work and are mapped automatically. No proxy setup or API key is needed.

Examples

Search for drills under $300

{
  "mode": "search",
  "searchQueries": ["cordless drill"],
  "storeId": "121",
  "priceMax": 300,
  "sortBy": "top_sellers",
  "maxItems": 50,
  "includeDetails": true,
  "includeStoreAvailability": true
}

Browse a category and keep only clearance

{
  "mode": "category",
  "categoryUrls": ["https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f"],
  "storeId": "121",
  "onlyClearance": true,
  "maxItems": 200,
  "maxPages": 10
}

Look up specific item IDs with reviews and aisle locations

{
  "mode": "products",
  "itemIds": ["320326787", "https://www.homedepot.com/p/Milwaukee-M18-FUEL-18V-Lithium-Ion-Brushless-Cordless-Hammer-Drill-and-Impact-Driver-Combo-Kit-2-Tool-with-2-Batteries-3697-22/320326787"],
  "storeId": "121",
  "includeDetails": true,
  "includeReviews": true,
  "maxReviewsPerProduct": 20,
  "includeStoreAvailability": true,
  "includeAisleBay": true
}

Find the nearest store from a ZIP

{
  "mode": "search",
  "searchQueries": ["pressure washer"],
  "storeId": "",
  "zipCode": "30339",
  "includeStoreAvailability": true,
  "maxItems": 25
}

Use cases

  • Price monitoring — compare store-local prices and promotions over time.
  • Restock and pickup tracking — watch shelf pickup quantities at one store.
  • Assortment and catalog research — pull a whole category with specs, brands and variants.
  • Comparison shopping — collect models, UPCs, ratings and media for a shortlist.
  • Voice-of-customer research — sample reviews and Q&A across competing products.

FAQ

Is this affiliated with Home Depot? No. This is an independent, third-party actor that reads publicly visible Home Depot product data. It is not operated by or affiliated with The Home Depot.

Which store are the prices and stock from? They come from the storeId you enter (default 121, Cumberland, GA). If you leave storeId empty and supply zipCode, the nearest store is used. Change the store to see that store's price and shelf quantity.

What is the difference between pickup and delivery stock? storeQuantity and pickupInStock are the shelf quantity available for pickup at the selected store. deliveryQuantity, deliveryAvailable and the delivery options describe the online/delivery pool. They are separate pools and are never added together.

Why are some fields missing on a product? Home Depot does not expose every field for every product. Fields with no real value are omitted rather than filled with null, zero or a placeholder. Variants, specs, videos and aisle locations appear only when the product has them. Aisle and bay are added only for products with pickup stock at the selected store.

How many products can one run return? maxItems is the overall cap and maxItemsPerQuery caps each query or category. Each page holds up to 24 products, and a category can be paged up to 30 times (720 products). For a larger category, narrow it by price or brand, or split it into smaller categories.

Can I get every review for a product with thousands of reviews? No. Reviews are optional and capped by maxReviewsPerProduct (default 20). The actor reads review pages until it reaches that cap or the end of the review list. The total review count and rating breakdown still show the full picture, but only the requested number of review texts is saved.

Do I need a proxy or an API key? No. Enter a store and the products you want; the actor handles access automatically.

What happens if Home Depot refuses a request? The actor retries with a few fresh browser sessions. If every attempt is refused, the run ends with a status message naming the source and saves no placeholder rows; re-run later.

Does this work for Home Depot Canada or Mexico? No. This actor covers the US storefront only. Canadian and Mexican stores are separate sites with different product IDs and stock.

Why does the price differ from the first page I see on the website? The site personalises price and availability by store. Make sure the storeId in your input is the store you are comparing against.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build wuFfPsyQX2r5dL5kR. Documentation is regenerated from the default published build; private drafts are not included.