# Home Depot Reviews API (https://www.socialcrawl.dev/platforms/home_depot/reviews)

> Returns written customer reviews for a Home Depot product, 20 per page and up to 100, each with the review text, star rating, reviewer name, submission date, verified-purchaser flag, helpful-vote count, reviewer photos, and any manufacturer reply. This is the fastest and most complete review surface in the API: pages do not overlap, the review total is stable across pages, and every one of the nine review fields is populated, so a full crawl is deterministic. Pass the returned cursor back until has_more is false.

TL;DR: `GET /v1/home_depot/reviews` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `item_id` | yes | Home Depot internet number (item id), the numeric id at the end of a homedepot.com product URL: homedepot.com/p/<name>/326680222 is item id 326680222. Pass url instead if you would rather hand over the whole product URL. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `items_per_page` | no | Reviews per page, 1 to 100. Defaults to 20. |
| `rating` | no | Return only reviews with this star rating, 1 to 5. |
| `sort_by` | no | Review ordering: helpful (default), newest, oldest, photos_first, highest_rating, lowest_rating, or relevance. (helpful \| newest \| oldest \| photos_first \| highest_rating \| lowest_rating \| relevance) |
| `search_text` | no | Return only reviews whose text contains these words, for example easy to use. |
| `verified_only` | no | Set true to return only reviews written by verified purchasers. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/home_depot/reviews?item_id=326680222" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How many reviews come back per page?

Twenty by default and up to one hundred, which is the widest review page in this API. Page through with the universal cursor.

### Are manufacturer replies included?

Yes. Where the brand has responded, the reply arrives on the review with its author and date, cleaned of the tracking markup Home Depot wraps it in.

### Can I filter to verified purchasers only?

Yes, with the verified-only flag. You can also filter by star rating or search the review text for specific words.

### How do I sort Home Depot reviews?

By helpfulness, newest, oldest, photos first, highest rating, lowest rating or relevance. Helpfulness is the default.

### Is the review total trustworthy?

Yes. It held identical across consecutive pages when measured, unlike the search totals on some other retailers, so you can size a crawl from it.

See the full Home Depot API: https://www.socialcrawl.dev/platforms/home_depot

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I pull Home Depot customer reviews with an API?
- Can I filter Home Depot reviews to verified purchasers?
- Do Home Depot review pages repeat the same reviews?