{
  "openapi": "3.0.1",
  "info": {
    "title": "Home Depot Products & Prices Scraper - No Login",
    "description": "Collect Home Depot prices, store stock, aisle and bay, reviews and Q&A by search, category, item ID or ZIP code, and compare nearby stores. No login or API key.",
    "version": "0.1",
    "x-build-id": "zkG0Cc29Rr1djvqin"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cliqtomedia~home-depot-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cliqtomedia-home-depot-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/cliqtomedia~home-depot-scraper/runs": {
      "post": {
        "operationId": "runs-sync-cliqtomedia-home-depot-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/cliqtomedia~home-depot-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-cliqtomedia-home-depot-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Data to collect",
            "enum": [
              "search",
              "product",
              "reviews",
              "questions",
              "stores"
            ],
            "type": "string",
            "description": "Choose what to collect: search and category results, product details, customer reviews, questions and answers, or store locations. One mode per run. Default: Search and category results.",
            "default": "search"
          },
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "Words to search on Home Depot, one per line, for example cordless drill. Used in Search and category results mode. This mode needs a search term or a category link.",
            "items": {
              "type": "string"
            }
          },
          "categoryUrls": {
            "title": "Category links",
            "type": "array",
            "description": "Home Depot category or search links, one per line, for example https://www.homedepot.com/b/Tools-Power-Tools-Drills/N-5yc1vZc27f. Used in Search and category results mode.",
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Product links or item IDs",
            "type": "array",
            "description": "Home Depot product links or item IDs, one per line, for example 317987598. Required for Product details, Customer reviews, and Questions and answers modes. Duplicates are removed.",
            "items": {
              "type": "string"
            }
          },
          "storeId": {
            "title": "Store number",
            "type": "string",
            "description": "The store used for price, stock, aisle and bay, for example 121. Empty: the store nearest to the ZIP code, or store 121 when there is no ZIP code. The run reports which store was used."
          },
          "zipCode": {
            "title": "ZIP code",
            "type": "string",
            "description": "A 5-digit US ZIP code, for example 30339. It sets delivery dates, picks the nearest store when Store number is empty, and is the center for Nearby stores. Required for Store locations mode."
          },
          "nearbyStores": {
            "title": "Nearby stores to compare",
            "minimum": 0,
            "maximum": 29,
            "type": "integer",
            "description": "Also read price and stock in this many stores nearest to the ZIP code, up to 29. Each extra store is charged per product. Default: 0.",
            "default": 0
          },
          "radiusMiles": {
            "title": "Store radius in miles",
            "minimum": 1,
            "maximum": 500,
            "type": "number",
            "description": "Keep only stores within this distance of the ZIP code, for Nearby stores and Store locations mode. Empty: no distance limit."
          },
          "extraStoreIds": {
            "title": "More stores to compare",
            "type": "array",
            "description": "Store numbers to read in addition to the main store, one per line, for example 616. Up to 50. Each extra store is charged per product.",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort results by",
            "enum": [
              "best_match",
              "top_sellers",
              "top_rated",
              "price_low",
              "price_high"
            ],
            "type": "string",
            "description": "The order of search and category results. Default: Best match.",
            "default": "best_match"
          },
          "inStoreOnly": {
            "title": "Only products sold in this store",
            "type": "boolean",
            "description": "Ask Home Depot for products sold in the chosen store only. Search and category results only. Default: off.",
            "default": false
          },
          "onlyInStock": {
            "title": "Only products in stock",
            "type": "boolean",
            "description": "Keep products shown as in stock or limited stock. Default: off.",
            "default": false
          },
          "onlyOnSale": {
            "title": "Only products on sale",
            "type": "boolean",
            "description": "Keep products with a lower current price than their previous price. Default: off.",
            "default": false
          },
          "onlyClearance": {
            "title": "Only clearance products",
            "type": "boolean",
            "description": "Read Home Depot's clearance list. Search and category results only. The list is shared by all stores, so the clearance price can be empty for your store. Default: off.",
            "default": false
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Keep products at or above this price in US dollars. Products without a price are skipped when this is set."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Keep products at or below this price in US dollars. Products without a price are skipped when this is set."
          },
          "minDiscountPercent": {
            "title": "Minimum discount percent",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Keep products with at least this discount, from 0 to 100."
          },
          "maxItems": {
            "title": "Maximum products",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "The most products to return in one run, from 1 to 5000. In review and question modes, this is the most rows in one run. Default: 10.",
            "default": 10
          },
          "maxItemsPerQuery": {
            "title": "Maximum products per search",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "The most products from each search term or category link. Empty: only Maximum products applies."
          },
          "includeDetails": {
            "title": "Add full product details",
            "type": "boolean",
            "description": "Add the description, specifications, documents and all images to each search result. This makes one more request and one more charge per product. Default: off.",
            "default": false
          },
          "includeReviews": {
            "title": "Add customer reviews",
            "type": "boolean",
            "description": "Add review rows and rating statistics for each product in search and product modes. Each review is charged. Default: off.",
            "default": false
          },
          "maxReviews": {
            "title": "Maximum reviews per product",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "The most reviews for each product, from 1 to 2000. Default: 20.",
            "default": 20
          },
          "reviewsSort": {
            "title": "Sort reviews by",
            "enum": [
              "newest",
              "oldest",
              "most_helpful",
              "highest_rating",
              "lowest_rating",
              "with_photos"
            ],
            "type": "string",
            "description": "The order of customer reviews. Default: Newest.",
            "default": "newest"
          },
          "reviewStars": {
            "title": "Only these star ratings",
            "type": "array",
            "description": "Keep reviews with these ratings, for example 1 and 2. Empty: all ratings.",
            "items": {
              "type": "integer",
              "minimum": 1,
              "maximum": 5
            }
          },
          "verifiedOnly": {
            "title": "Only verified purchases",
            "type": "boolean",
            "description": "Keep reviews from verified purchases. Default: off.",
            "default": false
          },
          "includeQuestions": {
            "title": "Add questions and answers",
            "type": "boolean",
            "description": "Add question rows with their answers for each product in search and product modes. Each question is charged. Default: off.",
            "default": false
          },
          "maxQuestions": {
            "title": "Maximum questions per product",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "The most questions for each product, from 1 to 2000. Default: 20.",
            "default": 20
          },
          "maxStores": {
            "title": "Maximum stores",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "The most stores to return in Store locations mode, from 1 to 30. Default: 10.",
            "default": 10
          },
          "trackChanges": {
            "title": "Compare with the last run",
            "type": "boolean",
            "description": "Mark each product as new, changed or unchanged since the last run with the same list name. Default: off.",
            "default": false
          },
          "onlyChanges": {
            "title": "Return only new and changed products",
            "type": "boolean",
            "description": "Leave out unchanged products. This also turns on Compare with the last run. Default: off.",
            "default": false
          },
          "minQuantityChange": {
            "title": "Smallest stock change to report",
            "minimum": 1,
            "type": "integer",
            "description": "A stock change smaller than this number counts as unchanged. Price changes always count. Default: 1.",
            "default": 1
          },
          "monitorName": {
            "title": "Comparison list name",
            "type": "string",
            "description": "Keep separate comparison history for each list, for example atlanta-drills. Letters, digits and hyphens, up to 40 characters. Default: default.",
            "default": "default"
          },
          "deliveryConnector": {
            "title": "Send results to (optional)",
            "type": "string",
            "description": "Your Slack, Notion or other MCP connector. After the run the Actor posts a short summary there. Connect services once in Apify Console → MCP connectors."
          },
          "deliveryTarget": {
            "title": "Notion page or channel (optional)",
            "type": "string",
            "description": "Where to post the summary: a Notion page link (each run is added on top of that page) or a Slack channel ID. Leave empty to let the connector decide."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}