Home Depot
US home-improvement products with the price, stock and aisle at a named store, plus every search filter, reviews, Q&A and deals.
/home-depot/v1/search2 creditsKeyword search with Home Depot's own facets (with counts), 7 sort orders, price range, store and ZIP. 24 rows per page, up to 30 pages.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words, as typed into homedepot.com's search box. A word Home Depot maps to a category (e.g. 'hammer', 'dewalt') returns that category's products, flagged `redirected_to_category`. |
| store_id | optional | — | Home Depot store number (121 or 0121). Prices, pickup stock and aisle are that store's. Without store_id and zip the store is #121 Cumberland, Atlanta GA (`store.is_default: true`). |
| zip | optional | — | US ZIP code: the nearest Home Depot store is used (one extra lookup, cached), and delivery dates/charges are for this ZIP. |
| sort = best_match | optional | best_match · price_asc · price_desc · top_sellers · top_rated · newest · most_popular | Order of the results. For a complete walk of a long keyword listing use a fixed order (price_asc / price_desc): best_match pages can repeat 1-3 rows between pages. |
| page = 1 | optional | 1–30 | Results page (1-30). Home Depot serves at most 744 rows per listing. |
| page_size = 24 | optional | 1–24 | Rows per page, 1-24 (24 is the site's own and its maximum). |
| min_price | optional | 0– | Lowest price, USD. |
| max_price | optional | 0– | Highest price, USD. |
| refinements | optional | — | Facet values to filter by, as `refinement` keys from this action's own `facets` (brand, rating, Get It Fast / pickup today, features, …). Several keys combine. |
| brand | optional | — | Brand name(s) as shown in the Brand facet; resolved to refinement keys (one extra lightweight request). |
| min_rating | optional | 1–5 | Minimum star rating (the site's Review Rating facet; one extra lightweight request). |
| pickup_today | optional | — | Only products in stock for pickup today at the store (the site's Get It Fast facet; one extra lightweight request). |
/home-depot/v1/category2 creditsA category's products (browse code or /b/ link) with the same facets, filters and sorts as search.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | required | — | A category as its browse code (N-5yc1vZc27f = Drills) or a homedepot.com /b/ link. Codes come from `categories`, from search `facets`/`related_categories`, and from product `breadcrumbs`. |
| store_id | optional | — | Home Depot store number (121 or 0121). Prices, pickup stock and aisle are that store's. Without store_id and zip the store is #121 Cumberland, Atlanta GA (`store.is_default: true`). |
| zip | optional | — | US ZIP code: the nearest Home Depot store is used (one extra lookup, cached), and delivery dates/charges are for this ZIP. |
| sort = best_match | optional | best_match · price_asc · price_desc · top_sellers · top_rated · newest · most_popular | Order of the results. For a complete walk of a long keyword listing use a fixed order (price_asc / price_desc): best_match pages can repeat 1-3 rows between pages. |
| page = 1 | optional | 1–30 | Results page (1-30). Home Depot serves at most 744 rows per listing. |
| page_size = 24 | optional | 1–24 | Rows per page, 1-24 (24 is the site's own and its maximum). |
| min_price | optional | 0– | Lowest price, USD. |
| max_price | optional | 0– | Highest price, USD. |
| refinements | optional | — | Facet values to filter by, as `refinement` keys from this action's own `facets` (brand, rating, Get It Fast / pickup today, features, …). Several keys combine. |
| brand | optional | — | Brand name(s) as shown in the Brand facet; resolved to refinement keys (one extra lightweight request). |
| min_rating | optional | 1–5 | Minimum star rating (the site's Review Rating facet; one extra lightweight request). |
| pickup_today | optional | — | Only products in stock for pickup today at the store (the site's Get It Fast facet; one extra lightweight request). |
/home-depot/v1/product/detail2 creditsOne product: store price and was-price, pickup stock and aisle/bay at the store, ship-to-home and delivery, specifications, key features, UPC, model and SKU numbers, rating and review count, images and videos.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | Home Depot item id (the 9 digits at the end of a /p/ link), a homedepot.com product link, or a model number / store SKU (resolved through search). |
| store_id | optional | — | Home Depot store number (121 or 0121). Prices, pickup stock and aisle are that store's. Without store_id and zip the store is #121 Cumberland, Atlanta GA (`store.is_default: true`). |
| zip | optional | — | US ZIP code: the nearest Home Depot store is used (one extra lookup, cached), and delivery dates/charges are for this ZIP. |
| include_aisle = true | optional | — | Also read the product's aisle and bay at the store (one small extra request). |
/home-depot/v1/product/batch3 creditsUp to 40 products in one request (list fields: price, was-price, stock at the store, rating). Ids Home Depot does not know are listed in `not_found`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_ids | required | — | 1-40 Home Depot item ids (9 digits). |
| store_id | optional | — | Home Depot store number (121 or 0121). Prices, pickup stock and aisle are that store's. Without store_id and zip the store is #121 Cumberland, Atlanta GA (`store.is_default: true`). |
| zip | optional | — | US ZIP code: the nearest Home Depot store is used (one extra lookup, cached), and delivery dates/charges are for this ZIP. |
/home-depot/v1/product/availability1 creditOne product at the nearest stores: each store's price, pickup quantity, aisle/bay, distance and phone.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | Home Depot item id (the 9 digits at the end of a /p/ link), a homedepot.com product link, or a model number / store SKU (resolved through search). |
| zip | optional | — | ZIP, store number, 'City, ST' or 'lat,lng' to search stores around (default ZIP 30339, Atlanta). |
| max_stores = 3 | optional | 1–10 | How many of the nearest stores (1-10); each store is two small requests. |
/home-depot/v1/product/reviews2 creditsCustomer reviews, 10 per page, with sort, star filter, verified-only, keyword search, and this-product-only or all variants (the site's default). Each row names its own product.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | Home Depot item id (the 9 digits at the end of a /p/ link), a homedepot.com product link, or a model number / store SKU (resolved through search). |
| sort = most_helpful | optional | most_helpful · newest · oldest · highest_rating · lowest_rating · with_photos | — |
| rating | optional | — | Only these star ratings (1-5). |
| verified_only = false | optional | — | Only verified purchasers. |
| include_variants = true | optional | — | Home Depot shows the reviews of every variant of a product (sizes, kits) together; false returns only this product's own reviews. |
| search | optional | — | Only reviews mentioning these words. |
| page = 1 | optional | 1–1000 | Page of 10 reviews (Home Depot's fixed page size). |
/home-depot/v1/product/questions2 creditsCustomer questions with all their answers (brand answers flagged), newest or oldest first, keyword search, up to 50 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | required | — | Home Depot item id (the 9 digits at the end of a /p/ link), a homedepot.com product link, or a model number / store SKU (resolved through search). |
| sort = newest | optional | newest · oldest | — |
| search | optional | — | Only questions/answers mentioning these words. |
| page = 1 | optional | 1–500 | — |
| page_size = 10 | optional | 1–50 | — |
/home-depot/v1/stores2 creditsStore locator: stores near a ZIP, 'City, ST', 'lat,lng' or a store number, with address, coordinates, phones, hours, curbside and tool-rental hours, and services.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | ZIP, 'City, ST', 'lat,lng', or a store number (that store comes first, distance 0). |
| limit = 10 | optional | 1–40 | — |
/home-depot/v1/deals3 creditsToday's Special Buy of the Day, or this week's Pro Special Buys, with every product priced at the store.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| period = day | optional | day · pro | — |
| store_id | optional | — | Home Depot store number (121 or 0121). Prices, pickup stock and aisle are that store's. Without store_id and zip the store is #121 Cumberland, Atlanta GA (`store.is_default: true`). |
| zip | optional | — | US ZIP code: the nearest Home Depot store is used (one extra lookup, cached), and delivery dates/charges are for this ZIP. |
/home-depot/v1/categories2 creditsWithout `category`: Home Depot's departments. With `category`: that category's sub-categories with product counts (and its breadcrumb).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | optional | — | Browse code or /b/ link; omit for the department list. |
| store_id | optional | — | Home Depot store number (121 or 0121). Prices, pickup stock and aisle are that store's. Without store_id and zip the store is #121 Cumberland, Atlanta GA (`store.is_default: true`). |
/home-depot/v1/suggest2 creditsSearch-box suggestions as you type (Home Depot's typeahead).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | — |
curl -X POST https://api.reefapi.com/home-depot/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"cordless drill"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.