# Home Depot Products By Category

> Home Depot Products By Category 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).

Browse and filter all Home Depot products within a specific category, with support for pagination, sorting, price ranges, brand filtering, stock availability, and store/zip localization.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-homedepot-data/products-by-category?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-products-by-category-e8a6593c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b4-GqxBcvQfrhMt0PwnYT

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-products-by-category-e8a6593c
```

Example prompt: Show me the top-selling DEWALT power tools from Home Depot category 5yc1vZc2bp, filtered to products between $50 and $300 that are currently in stock, near zip code 30301 — give me the first 24 results.

## When to prefer this

Use this endpoint when you know a specific Home Depot category ID and want to browse or filter all products within that category. Prefer this over a keyword search when navigating Home Depot's category tree (e.g., from breadcrumbs or category page URLs), or when you want to enumerate products in a well-defined product family. Especially useful when combining brand, price range, and in-stock filters within a known category context.

## Known failure modes

- Invalid or non-existent category_id returns empty results or error
- Invalid store_id or zipcode returns unlocalized or error response
- Page number exceeding total_pages returns empty product array
- Rate limiting or credit exhaustion returns 402 Payment Required
- Network timeout or upstream Home Depot data unavailability returns 5xx error

## How this service works

Browse all Home Depot products within a specific category. Supports pagination, sorting, price-range, brand, and in-stock filters, and store/zip localization. Returns the same product structure as Search.

## Output

Returns a paginated list of Home Depot products in the specified category, including product titles, brand names, model numbers, SKUs, UPCs, thumbnail and full images, pricing, star ratings, total review counts, stock availability, buyability flags, availability type, and available refinement filters (dimensions) for further narrowing. Also includes total result count, total pages, current page, and items per page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "category_id"
 ],
 "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"
  },
  "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)."
  },
  "category_id": {
   "type": "string",
   "description": "Home Depot category id (navigation parameter) of the category to browse. Category ids appear in Home Depot category page URLs (the `N-...` segment) and in the `breadcrumbs` / `filters` of Search responses.\n\n**Examples:**\n- 5yc1vZc2bp\n- 5yc1vZc28b"
  },
  "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-products-by-category-e8a6593c/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)