Overview

The Home Depot Product Lookup API retrieves real-time product pricing, availability, inventory, and product details using a Home Depot product ID and ZIP code.

Each lookup returns the product information and the nearest Home Depot store for the supplied ZIP code, including store details, price, sale price, bulk pricing, available quantity, description, product URL, and image URL.

When to Use This Actor

Use this Actor when you have a Home Depot product ID and a ZIP code and need current information such as:

• Home Depot product price
• Sale price or bulk pricing
• Product availability or inventory quantity
• Product details and description
• Product URL or image
• Nearest Home Depot store information
• Store distance, address, phone number, or hours

Each lookup returns data for one product at one nearest Home Depot store.

Example Use Cases

This Actor can be used for requests such as:

• "What is the current price of Home Depot product 311335459 near ZIP 10918?"
• "Is Home Depot product 313383605 in stock near 10918?"
• "How much does this Home Depot product cost at my nearest store?"
• "Get the current Home Depot price and availability for this product ID."
• "Check the availability and price of this Home Depot product near me."
• "Get the product details and nearest store information for Home Depot product 311335459."

Free Users

Free users are limited to a maximum of 10 lookups per day and up to 100 lookups per month. Please reach out if you need additional requests to validate your use case.

Key Features

• Real-Time Data: Get current Home Depot product pricing and availability.
• ZIP-Based Lookup: Find product information for the nearest Home Depot store to a ZIP code.
• Product Details: Get pricing, inventory, description, URL, image, and other product information.
• Structured JSON: Results are returned as structured JSON for easy use in applications, automation, and AI agents.

Input Schema

IMPORTANT

Runtime may vary significantly depending on caching. Set the timeout to at least 180s to prevent Apify from timing out the request before a response is returned.

Parameter	Type	Required	Description
zip	string	yes	The ZIP code used to determine the nearest Home Depot store for the lookup.
productId	string	yes	The Home Depot product ID to look up.
noWait	boolean	no	If true, the lookup is processed asynchronously and an asyncId is returned immediately.
callback	string	no	If set, an asyncId is returned immediately and the results will be provided via the callback. Note that this has an increased cost for the run.
bypassCache	boolean	no	COMING SOON: If true, the request will ignore all caches to ensure a fresh capture of all data. Note that this has an increased cost for the run.

If the lookup completes quickly, the product details are returned directly in the response.

Asynchronous Lookup

Some lookups may take longer to complete. Asynchronous processing allows the lookup to continue while the result is retrieved separately.

An asyncId can be returned when:

• noWait is true
• callback is set
• The initial lookup takes too long to complete

The asyncId is used to check the lookup status and retrieve the final result.

Parameter	Type	Required	Description
asyncId	string	yes	An ID obtained from a previous lookup request when the lookup is being processed asynchronously. Use this to check the status and retrieve the results.

Async Status Codes

A request using an asyncId returns one of the following states:

202 - Queued

The lookup has not started yet.

{
  "asyncId": "abcd-1234-efgh-5678",
  "status": 202
}

206 - In Progress

The lookup is currently being processed.

{
  "asyncId": "abcd-1234-efgh-5678",
  "status": 206
}

200 - Complete

The lookup has completed. The normal product lookup response is returned.

This asynchronous workflow applies when the initial lookup times out, noWait is true, or callback is set.

Output Schema

Successful Product Lookup Response

A completed lookup returns the product and nearest store information.

{
  "status": 200,
  "stores": {
    "STORE_ID": {
      "id": "string",
      "name": "string",
      "address": "string",
      "city": "string",
      "state": "string",
      "zip": "string",
      "phone": "string",
      "distance": "number",
      "hours": {
        "mon": {
          "open": "string",
          "close": "string"
        },
        "tue": {
          "open": "string",
          "close": "string"
        },
        "wed": {
          "open": "string",
          "close": "string"
        },
        "thu": {
          "open": "string",
          "close": "string"
        },
        "fri": {
          "open": "string",
          "close": "string"
        },
        "sat": {
          "open": "string",
          "close": "string"
        },
        "sun": {
          "open": "string",
          "close": "string"
        }
      },
      "products": {
        "PRODUCT_ID": {
          "name": "string",
          "description": "string",
          "url": "string",
          "imageUrl": "string",
          "quantityAvailable": "number",
          "priceCentsPerUnit": "number",
          "salePriceCentsPerUnit": "number",
          "bulkQuantityRequired": "number",
          "bulkPriceCentsPerUnit": "number"
        }
      }
    }
  }
}

Error Responses

If the lookup cannot be completed, one of the following status codes will be returned.

422 - Lookup Cannot Be Completed

{
  "status": 422
}

A 422 is returned when the lookup cannot be completed due to an external reason, such as an invalid product ID. The request should not be retried.

If you believe a request was incorrectly rejected, please contact support.

429 - Rate Limited

{
  "status": 429
}

A 429 is returned when the system is under pressure and requests are being rate limited. The request should be retried at a later time.

500 - Unexpected Error

{
  "status": 500
}

A 500 is returned when an unexpected error occurs in the system.

Support

For issues or assistance, contact support via Apify or email help@maplerope.com.