{"uid":"cap_mHp2FXIDb0MeZiRtCPmgX","slug":"agents-openwebninja-com-home-depot-product-search-2e2e5572","name":"Home Depot Product Search","description":"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.","url":"https://agents.openwebninja.com/realtime-homedepot-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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`"}}},"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_dedb39e1cfebac02_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_dedb39e1cfebac02_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_1S1wLaPffSqysHWZnSEKj","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":"Search the Home Depot product catalog by keyword with filtering, sorting, pagination, and store/zip localization for pricing and availability.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Price-comparison shopping for power tools","prompt":"Find me all RYOBI cordless drills on Home Depot under $150 that are currently in stock, sorted by price low to high, for zip code 90210."},{"title":"Local store inventory check before visiting","prompt":"What Milwaukee tools does Home Depot store number 121 have in stock right now? Search for 'Milwaukee impact wrench' and show me only what's available."},{"title":"Top-rated home renovation products","prompt":"Search Home Depot for kitchen faucets sorted by top rated, show me the first page of results with at least a minimum price of $50 and a max of $400."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:35.705Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-home-depot-product-search-2e2e5572"}