List Home Depot product reviews
List reviews of a Home Depot product with star and aspect ratings, reviewer details, photos and review statistics.
Headers
Get your API keyAPI key (`sfk_...`)
Home Depot item id, the Internet # on the product page (`100497597`), or product page URL (`https://www.homedepot.com/p/KitchenAid-Artisan-5-Qt-10-Speed-Pistachio-Green-Stand-Mixer-with-Flat-Beater-Wire-Whip-and-Dough-Hook-Attachments-KSM150PSPT/100497597`).
min 1 chars · max 500 chars
Order of the reviews: `newest` (default), `oldest`, `highest_rating`, `lowest_rating` or `most_helpful`.
one of: newest, oldest, highest_rating, lowest_rating, most_helpful
Only reviews with this many stars, 1 to 5. Default: every rating.
≥ 1 · ≤ 5
Reviews per page, 1 to 100. Default: 30.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
`not_found` when Home Depot has no product with this id; a product with no reviews is `found` with an empty list.
one of: found, not_found
The item id asked for.
Reviews matching the filters, across every page.
Review statistics; null when not found.
Average stars out of 5.
Reviews, every page.
Reviewers who recommend it.
Reviewers who do not.
Reviews per star rating, 5 stars first.
Stars, 1 to 5.
Reviews with that many stars.
Photos across every review.
When the first review was posted. ISO 8601 UTC; null when not shown.
When the latest review was posted. ISO 8601 UTC; null when not shown.
The average of each aspect rating, across every review.
Aspect, e.g. `Quality` or `Value`.
Aspect label as the site shows it; null when unknown.
How the site shows the rating: `stars` (more is better) or `slider` (a point between `minLabel` and `maxLabel`); null when unknown.
one of: stars, slider, null
Average across every review that rated this aspect.
Highest value possible, usually 5.
A slider's low end; null for stars.
A slider's high end; null for stars.
Reviews on this page.
Review id.
Item the review was written for; another colour or size of the same product can differ from `productId`.
Name of the item the review was written for.
Stars, 1 to 5.
Review title.
Review text.
Whether the reviewer left stars without text.
When it was posted. ISO 8601 UTC; null when not shown.
Reviewer's nickname.
Reviewer's location.
Whether the reviewer recommends it.
Whether the reviewer got the product free or a reward for an early review.
Whether the site marks the reviewer a verified buyer.
Whether the reviewer is a Home Depot employee.
Whether the review was first posted on another site.
The site a syndicated review was first posted on.
Readers who found it helpful.
Readers who did not.
Language and country, e.g. `en_US`.
Ratings of single aspects, such as quality, value or delivery: stars, or for a few products a scale between two ends.
Aspect, e.g. `Quality` or `Value`.
Aspect label as the site shows it, e.g. "Quality"; null when unknown.
How the site shows the rating: `stars` (more is better) or `slider` (a point between `minLabel` and `maxLabel`); null when unknown.
one of: stars, slider, null
The rating, 1 to `maxValue`: stars, or for a slider the point from `minLabel` (1) to `maxLabel`.
Highest value possible, usually 5.
The value as the site words it, e.g. "Runs large" for a 5 on fit; null when the site has no words for it.
A slider's low end, e.g. "Runs Small"; null for stars.
A slider's high end, e.g. "Runs Large"; null for stars.
What the reviewer said about themselves, such as age range and gender.
Field key, as the site names it.
Field label as the site shows it, e.g. "Age Range"; null when unknown.
Value id, e.g. `45to54`.
The value as the site shows it, e.g. "45 to 54"; null when unknown or free text.
Tags the reviewer picked as pros, e.g. `Easy to Use`.
Tags the reviewer picked as cons.
Badges the site shows beside the review, such as Top 1000 Contributor, DIY, Pro or Verified Purchaser.
Badge id, e.g. `top1000` or `verifiedPurchaser`.
The badge as the site shows it; null when unknown.
Attached photos.
Photo or video id.
Full-size URL.
Thumbnail URL.
Caption, when given.
Attached videos.
Photo or video id.
Full-size URL.
Thumbnail URL.
Caption, when given.
Replies from the brand or Home Depot.
Who responded.
Response text.
When they responded. ISO 8601 UTC; null when not shown.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/home-depot/product/reviews?productId=100497597" \
-H "x-api-key: YOUR_API_KEY"Responses
Home Depot product reviews.