# Home Depot Product Search

> Home Depot Product Search is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Search the Home Depot product catalog by keyword with filtering, sorting, pagination, and store/zip localization for pricing and availability.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-homedepot-data/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-home-depot-product-search-2e2e5572
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mHp2FXIDb0MeZiRtCPmgX

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-home-depot-product-search-2e2e5572
```

Example prompt: Search Home Depot for cordless impact drivers from DEWALT, priced between $100 and $300, in stock only, sorted by top sellers, and localize results to zip code 30301.

## When to prefer this

Use this endpoint when you need real-time Home Depot product search with filtering by brand, price range, and in-stock status, and especially when local store or zip-code-based pricing and availability matters. Prefer this over generic e-commerce APIs when the user specifically wants Home Depot products, needs Home Depot-specific store inventory, or wants to compare Home Depot pricing. Best for agents that need to present a paginated, sortable product catalog from Home Depot specifically.

## Known failure modes

- Missing required 'query' parameter returns a 400 validation error
- Invalid store_id or zipcode may return unlocalized or empty results
- Queries with no matching products return an empty products array
- Pages beyond total_pages return empty result sets
- Highly specific or misspelled queries may return zero results
- Rate limiting or quota exhaustion may return 402 or 429 errors
- Truncated or malformed responses if the upstream Home Depot API is temporarily unavailable

## How this service works

Search for all Home Depot products by keyword. Supports pagination, sorting (best match, top sellers, top rated, price, newest), price-range, brand, and in-stock filters, and store/zip localization for pricing and fulfillment.

## Output

Returns a paginated list of Home Depot products matching the query, including product title, brand, model number, SKU, UPC, thumbnail image, pricing, star rating, total reviews, in-stock status, availability type, and whether the product is sponsored or discontinued. Also includes available refinement filters (dimensions) such as brand, price range, and other category-specific attributes that can be used to narrow results further.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "maximum": 30,
   "minimum": 1,
   "description": "Page to return.\n\n**Allowed values:** `1-30`"
  },
  "brand": {
   "type": "string",
   "description": "Only return products of a specific brand.\n\n**Examples:**\n- DEWALT\n- Milwaukee\n- RYOBI"
  },
  "query": {
   "type": "string",
   "description": "Free-form product search query (keyword search).\n\n**Examples:**\n- drill\n- cordless impact driver\n- kitchen faucet"
  },
  "sort_by": {
   "enum": [
    "best_match",
    "top_sellers",
    "top_rated",
    "price_low_to_high",
    "price_high_to_low",
    "newest"
   ],
   "type": "string",
   "default": "best_match",
   "description": "Return the results in a specific sort order."
  },
  "zipcode": {
   "type": "string",
   "description": "5-digit US zip code used to localize delivery options and pricing.\n\n**Example:** `30301`"
  },
  "in_stock": {
   "type": "boolean",
   "default": false,
   "description": "Only return products that are currently in stock / fulfillable."
  },
  "store_id": {
   "type": "string",
   "description": "Home Depot store number used to localize pricing, inventory, and pickup availability.\n\n**Example:** `121`"
  },
  "max_price": {
   "type": "number",
   "description": "Only return products with a price less than or equal to this value (in USD)."
  },
  "min_price": {
   "type": "number",
   "description": "Only return products with a price greater than or equal to this value (in USD)."
  },
  "items_per_page": {
   "type": "integer",
   "default": 24,
   "maximum": 48,
   "minimum": 1,
   "description": "Number of products to return per page.\n\n**Allowed values:** `1-48`"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "parameters",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "total_results",
    "total_pages",
    "current_page",
    "results_count",
    "items_per_page",
    "products"
   ],
   "properties": {
    "filters": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "label",
       "is_color_swatch",
       "is_visual_nav",
       "options"
      ],
      "properties": {
       "label": {
        "type": "string",
        "example": "Brand",
        "description": "Filter (dimension) label."
       },
       "options": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "label"
         ],
         "properties": {
          "url": {
           "type": "string",
           "example": "/b/DEWALT/N-5yc1vZ4j2/Ntk-elastic/Ntt-DCD800B?NCNI-5",
           "nullable": true,
           "description": "URL applying this refinement."
          },
          "label": {
           "type": "string",
           "example": "DEWALT",
           "description": "Refinement option label."
          },
          "record_count": {
           "type": "string",
           "example": "54",
           "nullable": true,
           "description": "Number of products matching this refinement, returned as a string."
          },
          "refinement_key": {
           "type": "string",
           "example": "4j2",
           "nullable": true,
           "description": "Refinement key (used to build filtered category URLs)."
          }
         }
        },
        "description": "Up to 50 refinement options for this filter."
       },
       "dimension_id": {
        "type": "string",
        "example": "4",
        "nullable": true,
        "description": "Home Depot dimension id."
       },
       "is_visual_nav": {
        "type": "boolean",
        "example": true,
        "description": "Whether the filter is a visual navigation element."
       },
       "is_color_swatch": {
        "type": "boolean",
        "example": false,
        "description": "Whether the filter is rendered as color swatches."
       }
      }
     },
     "description": "Available refinement dimensions (filters) for the result set. Present when available."
    },
    "keyword": {
     "type": "string",
     "example": "drill",
     "description": "The resolved search keyword. Present for Search and Item Lookup."
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-home-depot-product-search-2e2e5572/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)