Home Depot

Home Depot Reviews API

Page through a Home Depot item's customer reviews as JSON: full review bodies, star rating and per-attribute ratings, recommend flag, helpful votes, reviewer name and location, submission timestamp, customer photos and videos, syndication source, and the brand's public response. 30 reviews per page. Costs 2 credits per request.

POST/api/v1/homedepot/reviews

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

item_idstringrequired

Home Depot item id, or a full homedepot.com/p/... product URL (tracking parameters are discarded). This is the item_id every Home Depot Search row and the Home Depot Product response return.

Example: 204279858

pageinteger

Reviews page, 1-based, minimum 1. 30 reviews per page. total_pages in the response is the LAST page that exists — asking past it is a 404, and that 404 IS billed because Home Depot answers it with a page we pay for. Read total_pages from page 1 and stop there.

Example: 2

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

first = client.home_depot.reviews("204279858")["data"]
print(first["rating"], first["total_results"], first["total_pages"])

for review in first["reviews"]:
    print(review["rating"], review["submitted_at"], review["title"])

# total_pages is the last page that EXISTS - going past it is a billed 404.
for page in range(2, min(first["total_pages"], 5) + 1):
    batch = client.home_depot.reviews("204279858", page=page)

Response

"item_id": "204279858",

"product_name": "20V MAX Cordless 1/2 in. Drill/Driver, (2) 20V 1.3Ah Batteries, Charger and Bag",

"url": "https://www.homedepot.com/p/DEWALT-20V-MAX-Cordless-1-2-in-Drill-Driver-2-20V-1-3Ah-Batteries-Charger-and-Bag-DCD771C2/204279858",

"rating": 4.7,

"total_results": 11351,

"recommended_count": 2400,

"not_recommended_count": 286,

"total_pages": 379,

"page": 1,

"page_size": 30,

"start_index": 1,

"sort": "photoreview",

"count": 30,

"response_time": 14996,

"credits_used": 2,

"credits_remaining": 4818

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") first = client.home_depot.reviews("204279858")["data"] print(first["rating"], first["total_results"], first["total_pages"]) for review in first["reviews"]: print(review["rating"], review["submitted_at"], review["title"]) # total_pages is the last page that EXISTS - going past it is a billed 404. for page in range(2, min(first["total_pages"], 5) + 1): batch = client.home_depot.reviews("204279858", page=page)