{"uid":"cap_b4-GqxBcvQfrhMt0PwnYT","slug":"agents-openwebninja-com-home-depot-products-by-category-e8a6593c","name":"Home Depot Products By Category","description":"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.","url":"https://agents.openwebninja.com/realtime-homedepot-data/products-by-category?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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`"}}},"responseSchema":{"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."},"products":{"type":"array","items":{"type":"object","required":["item_id","title","brand","model_no","sku_id","upc","product_type","sku_classification","thumbnail","images","pricing","rating","total_reviews","in_stock","is_buyable","availability_type","is_discontinued","backordered","is_sponsored","is_live_goods","hide_price","eco_rebates","url"],"properties":{"upc":{"type":"string","example":"0033287225422","nullable":true,"description":"UPC / GTIN-13 barcode. Null when not provided by Home Depot."},"url":{"type":"string","example":"https://www.homedepot.com/p/DEWALT-20V-MAX-Cordless-Drill-Driver-DCD771C2/204279858","nullable":true,"description":"Canonical Home Depot product page URL."},"brand":{"type":"string","example":"DEWALT","nullable":true,"description":"Brand / manufacturer name."},"title":{"type":"string","example":"20V MAX Cordless 1/2 in. Drill/Driver, (2) 20V 1.3Ah Batteries, Charger and Bag","nullable":true,"description":"Full product title as shown on Home Depot."},"badges":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"top rated","nullable":true,"description":"Badge internal name."},"label":{"type":"string","example":"Top Rated","nullable":true,"description":"Badge display label."}}},"description":"Merchandising badges on the product (e.g. Best Seller, Top Rated). Present when available."},"images":{"type":"array","items":{"type":"string","description":"Product image URL."},"nullable":true,"description":"List of product image URLs. Null when no images are available."},"rating":{"type":"number","example":4.6241,"nullable":true,"description":"Average customer rating (0-5). Null when the product has no reviews."},"sku_id":{"type":"string","example":"1000014677","nullable":true,"description":"Home Depot store SKU number."},"item_id":{"type":"string","example":"204279858","description":"Home Depot internet number (unique product id)."},"pricing":{"allOf":[{"$ref":"#/components/schemas/sds_L_Fsr74jXxRwFrRFUiukT_31f88892c8f25ad6_ref3"}],"nullable":true,"description":"Pricing information. Null when the product has no displayable price."},"features":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Voltage","description":"Feature name."},"value":{"type":"string","example":"20V","description":"Feature value."}}},"description":"Key product feature name/value pairs. Present when available on search results."},"in_stock":{"type":"boolean","example":true,"description":"Whether the product is currently in stock / buyable."},"model_no":{"type":"string","example":"DCD771C2","nullable":true,"description":"Manufacturer model number."},"thumbnail":{"type":"string","example":"https://images.thdstatic.com/productImages/8c8e6b8d/svn/dewalt-power-drills-dcd771c2-64_1000.jpg","nullable":true,"description":"Primary product image URL."},"department":{"type":"string","example":"Power Drills","description":"Product department name. Present when Home Depot provides department taxonomy."},"hide_price":{"type":"boolean","example":false,"description":"Whether Home Depot hides the price for this product."},"is_buyable":{"type":"boolean","example":true,"description":"Whether the product can currently be purchased."},"backordered":{"type":"boolean","example":false,"description":"Whether the product is currently backordered."},"breadcrumbs":{"type":"array","items":{"type":"string","example":"Tools","description":"Breadcrumb label."},"description":"Category breadcrumb labels (top-level to leaf). Present when available."},"description":{"type":"string","description":"Short product description. Rarely present on search results."},"eco_rebates":{"type":"string","example":null,"nullable":true,"description":"Eco-rebate information when available, otherwise null."},"fulfillment":{"allOf":[{"$ref":"#/components/schemas/sds_L_Fsr74jXxRwFrRFUiukT_31f88892c8f25ad6_ref4"}],"description":"Pickup and delivery fulfillment options. Present when available."},"class_number":{"type":"string","example":"9","description":"Product class number. Present when available."},"is_sponsored":{"type":"boolean","example":false,"description":"Whether this is a sponsored / paid-placement result."},"product_type":{"type":"string","example":"MERCHANDISE","nullable":true,"description":"Product type classification (e.g. MERCHANDISE)."},"subscription":{"type":"object","properties":{"enabled":{"type":"boolean","example":true,"description":"Whether subscription purchase is enabled."},"default_frequency":{"type":"string","nullable":true,"description":"Default delivery frequency."},"discount_percentage":{"type":"number","example":5,"nullable":true,"description":"Subscription discount percentage."}},"description":"Subscribe & Save information. Present only when subscription is enabled."},"department_id":{"type":"string","example":"569647","description":"Product department id. Present when available."},"is_live_goods":{"type":"boolean","example":false,"description":"Whether the product is a live good (e.g. live plants)."},"total_reviews":{"type":"string","example":"11296","description":"Total number of customer reviews, returned as a string. \"0\" when there are no reviews."},"is_discontinued":{"type":"boolean","example":false,"description":"Whether the product has been discontinued."},"seo_description":{"type":"string","description":"SEO product description. Present when available."},"product_sub_type":{"type":"object","properties":{"url":{"type":"string","nullable":true,"description":"Sub-type category URL."},"name":{"type":"string","example":"Cordless Drills","description":"Sub-type name."}},"description":"Product sub-type (sub-category). Present when available."},"availability_type":{"type":"string","example":"Online","nullable":true,"description":"Availability channel (e.g. Online, Shared, In Store)."},"sub_department_id":{"type":"string","example":"569648","description":"Product sub-department id. Present when available."},"sku_classification":{"type":"string","example":null,"nullable":true,"description":"SKU classification code. Null when not provided."},"excluded_ship_states":{"type":"array","items":{"type":"string","example":"CA","description":"2-letter US state code."},"description":"US states the product cannot ship to. Present only when shipping is restricted."}},"description":"A single Home Depot product as returned by Search, Products By Category, and Item Lookup."},"description":"Products on this page."},"brand_link":{"type":"object","properties":{"url":{"type":"string","nullable":true,"description":"Brand landing-page URL."},"label":{"type":"string","description":"Brand label."}},"description":"Brand landing-page link. Present for some category browses."},"breadcrumbs":{"type":"array","items":{"type":"object","required":["label"],"properties":{"url":{"type":"string","example":"https://www.homedepot.com/b/Tools/N-5yc1vZc1xy","nullable":true,"description":"Breadcrumb URL."},"label":{"type":"string","example":"Tools","description":"Breadcrumb label."},"dimension_name":{"type":"string","example":"Category","nullable":true,"description":"Dimension name for the breadcrumb."},"refinement_key":{"type":"string","example":"c1xy","nullable":true,"description":"Refinement key for the breadcrumb."}}},"description":"Category breadcrumb trail for the result set. Present when available."},"category_id":{"type":"string","example":"fc67ed91-4c88-454f-a837-e3a3a07f27a9","description":"Home Depot category id associated with the result set. Present when available."},"total_pages":{"type":"integer","example":30,"description":"Total number of pages available (capped at 30)."},"current_page":{"type":"integer","example":1,"description":"The page number returned."},"canonical_url":{"type":"string","example":"https://www.homedepot.com/b/Tools/N-5yc1vZc1xy/Ntk-elasticplus/Ntt-drill?NCNI-5","description":"Canonical Home Depot listing URL for this result set. Present when available."},"results_count":{"type":"integer","example":24,"description":"Number of products returned on this page."},"total_results":{"type":"integer","example":4939,"description":"Total number of matching products across all pages."},"items_per_page":{"type":"integer","example":24,"description":"Page size used for this request."},"applied_filters":{"type":"array","items":{"type":"object","properties":{"deselect_url":{"type":"string","nullable":true,"description":"URL that removes (deselects) this refinement."},"refinement_key":{"type":"string","nullable":true,"description":"Applied refinement key."},"dimension_label":{"type":"string","description":"Dimension label of the applied refinement."},"refinement_label":{"type":"string","description":"Applied refinement label."}}},"description":"Currently applied refinements. Present only when filters are active."},"search_redirect":{"type":"string","description":"Redirect target when Home Depot redirects the search. Present only when a redirect occurs."},"related_searches":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","nullable":true,"description":"Related search URL."},"title":{"type":"string","description":"Related search title."}}},"description":"Related search suggestions. Present when available."},"spelling_correction":{"type":"string","example":"drill","description":"Corrected keyword when Home Depot applied a spelling correction. Present only when corrected."}},"description":"Result-set metadata shared by Search, Products By Category, and Item Lookup."},"status":{"type":"string","example":"OK","description":"Response status. Always OK on success."},"parameters":{"type":"object","description":"The request parameters as received by the server.","additionalProperties":true},"request_id":{"type":"string","example":"4f2a9d6e-1b3c-4f5a-8c7d-9e0f1a2b3c4d","description":"Unique request identifier (UUID)."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_XQe8TmXC9PAIcYigMYADX","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Finding affordable in-stock power tools","prompt":"Can you browse Home Depot's power tools category (5yc1vZc2bp) and show me Milwaukee brand tools that are in stock and priced between $25 and $150, sorted by price low to high? I'm near zip code 60601."},{"title":"Comparing top-rated flooring products","prompt":"Pull up the top-rated products from Home Depot's flooring category 5yc1vZc28b — I want to see up to 48 results on the first page so I can compare options."},{"title":"Checking local store inventory for a specific brand","prompt":"I want to browse all RYOBI products in Home Depot category 5yc1vZc2bp that are currently in stock at store number 121, sorted by best match — show me the first page of results."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:32:58.681Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-home-depot-products-by-category-e8a6593c"}