> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/home-depot/product-reviews>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/home-depot/product-reviews.mdx>

---

# Home Depot Product Reviews API

Page through every review of a Home Depot product, newest first or by rating, with the product's review statistics.

`GET /v1/home-depot/product/reviews?productId=100497597` returns `data.reviews` and `data.stats`. Each review has `id`, `productId`, `productName`, `rating`, `title`, `text`, `isRatingsOnly`, `submittedAt`, `authorNickname`, `authorLocation`, `isRecommended`, `isIncentivized`, `isVerifiedPurchaser`, `isStaff`, `isSyndicated`, `syndicationSource`, `helpfulCount`, `notHelpfulCount`, `secondaryRatings` (quality, value, delivery and other aspects, each with its label and whether it is stars or a slider), the reviewer's self-described `attributes` with the words the site shows for them, the `pros` and `cons` tags they picked, `badges` such as Top 1000 Contributor, DIY or Pro, `photos`, `videos` and `brandResponses`. `stats` carries the average rating, recommendation counts, the 5-to-1 star distribution, photo count and the average of each aspect.

Sort with `sort` (`newest`, `oldest`, `highest_rating`, `lowest_rating`, `most_helpful`), filter with `rating`, and set `limit` up to 100. Keep requesting with `page.nextCursor` while `page.hasMore` is true. An item Home Depot doesn't have is `lookupStatus: not_found`; a product nobody has reviewed is `found` with no reviews.

## Request

- **Endpoint:** `GET /v1/home-depot/product/reviews`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by item id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/home-depot/product/reviews/get)
- **Platform page:** [/platforms/home-depot](https://www.socialfetch.dev/platforms/home-depot)

## FAQ

### How do I page through all reviews?

Request with limit up to 100, then pass page.nextCursor as cursor with the same productId, sort and rating until page.hasMore is false. Each page is its own request. A walk reads the reviews approved by the time it started, so reviews posted while you page don't push rows onto the next page. A review the site moderates again during the walk drops out of it, and most_helpful can reorder as votes come in, so with that sort a row can repeat or be missed.

### Can I get only one-star or five-star reviews?

Yes. Add rating=1 to rating=5. totalResults then counts only the matching reviews, while stats describes every review of the product.

### Why can a review's productId differ from the one I asked for?

Home Depot shares reviews across the colours and sizes of one product, so a review written for a related item can appear. Its own productId and productName show which one.

### What are secondaryRatings?

Ratings the reviewer gave single aspects of the product or the order, such as Quality, Value or Delivery, each with its label and maximum. Most are stars; the few sliders (such as fit, from runs small to runs large) have displayType slider and the site's words for each end.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
