# Home Depot reviews: `POST /v1/homedepot/reviews`

Cost: 2 credits (2 per page (an unknown item, an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/homedepot-reviews

Ten reviews a page for one product, newest first by default.

Each review has its rating, title, text, date, the reviewer's display
name and location as shown on the site, whether they recommend it,
helpful votes, badges (such as verified purchaser), photo links, replies
from the brand, and `reviewed_item_id`: Home Depot pools reviews across a
product's sizes and colors, so a review may be for a sibling item.
`summary` has the average rating, the review count, recommend counts and
the 1-5 star histogram; with `rating` set it counts only that star
level. Page with `page` while `search_information.has_more` is true. An
unknown item is a 404 and is not billed; an empty page is not billed.

Request body (JSON):

- `item_id` (string | null; optional; pattern ^\d{9}$): The 9-digit item id (the number at the end of a product link, or `item_id` from a search).
- `url` (string | null; optional; max length 1000): A homedepot.com/p/ product link instead of `item_id`.
- `sort` (string; optional; default newest; one of newest, oldest, highest_rating, lowest_rating, most_helpful, with_photos): Review order: newest (default), oldest, highest_rating, lowest_rating, most_helpful, or with_photos (reviews with photos first).
- `page` (integer; optional; default 1; min 1, max 500): Review page, 10 reviews a page.
- `rating` (integer | null; optional; min 1, max 5): Only reviews with this star rating (1-5).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
