Homedepot reviews API documentation
We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:
- The Homedepot API returns 10 reviews per request.
- The order in which reviews are returned is by descending date(from newest to oldest).
- You can get all reviews from a single product by using the
offsetparameter.
To get reviews from Wextractor you will need to perform GET requests against
the https://wextractor.com/api/v1/reviews/homedepot endpoint.
Reviews endpoint parameters:
| Parameter | Required | Description | Example |
|---|---|---|---|
| auth_token | Required | Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. | - |
| id | Required | A textual identifier that uniquely identifies a product in Homedepot. This identifier can be taken from the url of the product in Homedepot. For example, if the url for the product in Homedepot is https://www.homedepot.com/p/RoomMates-4-in-x-16-74-in-16-Piece-Multi-Color-Distressed-Barn-Wood-Plank-Peel-and-Stick-Wall-Decals-RMK3695GM/303352661 the identifier is 303352661
|
303352661 |
| offset | Optional | This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.). | 10 |
Example usage:
https://wextractor.com/api/v1/reviews/homedepot?id=303352661&auth_token=XXXXX&offset=0
Example response:
{
"totals": {
"review_count": 143
},
"reviews": [
{
"id": "254552976",
"is_recommended": false,
"is_verified_purchase": true,
"datetime": "2022-02-09T15:19:37.000+00:00",
"rating": "5",
"text": "These are very easy to work with and they look great.",
"title": "These are very easy to work with and they look...",
"reviewer": "JACQUELINE"
},
{
"id": "254529467",
"is_recommended": false,
"is_verified_purchase": true,
"datetime": "2022-02-08T23:52:32.000+00:00",
"rating": "5",
"text": null,
"title": null,
"reviewer": "MICHAEL"
},
{
"id": "254065393",
"is_recommended": false,
"is_verified_purchase": false,
"datetime": "2022-01-25T16:51:50.000+00:00",
"rating": "5",
"text": "Perfect for a splash of color under my bar area.",
"title": "Perfect for a splash of color under my bar area....",
"reviewer": "DEE DEE S"
},
{
"id": "251755894",
"is_recommended": false,
"is_verified_purchase": false,
"datetime": "2021-11-17T15:40:47.000+00:00",
"rating": "5",
"text": null,
"title": null,
"reviewer": "Sanz"
},
{
"id": "251246548",
"is_recommended": true,
"is_verified_purchase": true,
"datetime": "2021-11-02T14:19:51.000+00:00",
"rating": "5",
"text": "Transforms the wall completely. Even the little bumps in the wall become a \"feature\" giving it depth. Sticks and stays put until removed.",
"title": "Easy to Use",
"reviewer": "NorthCountryMama"
},
{
"id": "250910061",
"is_recommended": true,
"is_verified_purchase": true,
"datetime": "2021-10-23T16:04:21.000+00:00",
"rating": "5",
"text": "Easy to use. Nice project aid.",
"title": "Easy to use",
"reviewer": "klotzmom3"
},
{
"id": "250675162",
"is_recommended": false,
"is_verified_purchase": false,
"datetime": "2021-10-16T07:59:08.000+00:00",
"rating": "5",
"text": null,
"title": null,
"reviewer": "HomeDepotCustomer"
},
{
"id": "250367248",
"is_recommended": false,
"is_verified_purchase": false,
"datetime": "2021-10-06T01:26:20.000+00:00",
"rating": "5",
"text": null,
"title": null,
"reviewer": "Edgar"
},
{
"id": "249979576",
"is_recommended": false,
"is_verified_purchase": false,
"datetime": "2021-09-22T08:03:33.000+00:00",
"rating": "5",
"text": "Rating provided by a verified purchaser",
"title": "Rating provided by a verified purchaser...",
"reviewer": "LEON"
},
{
"id": "248918937",
"is_recommended": false,
"is_verified_purchase": false,
"datetime": "2021-08-14T11:54:39.000+00:00",
"rating": "5",
"text": "I love this product!",
"title": "I love this product!...",
"reviewer": "TERRI"
}
]
}
Frequently asked questions:
- How do I get all the reviews for a single product?
- Does the API have rate limits?
You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.
Yes, since Homedepot is pretty strict at blocking requests you will be rate limited if you perform more than ten requests per second.