Home Depot hub

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

1 credit Failed requests are free Found, empty and not-found answers are all charged

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Home Depot Product Reviews API 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.