{"uid":"cap_oUzOAMBbnAkTgsesLHPK0","slug":"agents-openwebninja-com-home-depot-product-reviews-aec49dbe","name":"Home Depot Product Reviews","description":"Get paginated customer reviews for a Home Depot product by its internet (item) number. Returns review text, rating, author, verified-purchaser status, photos, merchant responses, and product-level rating statistics with a full 1-5 star histogram.","url":"https://agents.openwebninja.com/realtime-homedepot-data/product-reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["item_id"],"properties":{"page":{"type":"integer","default":1,"maximum":51,"minimum":1,"description":"Page to return.\n\n**Allowed values:** `1-51`"},"rating":{"type":"integer","maximum":5,"minimum":1,"description":"Only return reviews with a specific star rating.\n\n**Allowed values:** `1-5`"},"item_id":{"type":"string","description":"The Home Depot internet number (item id) of the product to return reviews for.\n\n**Examples:**\n- 300569432\n- 326680222"},"sort_by":{"enum":["helpful","newest","oldest","photos_first","highest_rating","lowest_rating","relevance"],"type":"string","default":"helpful","description":"Return the reviews in a specific sort order."},"search_text":{"type":"string","description":"Only return reviews whose text contains the given keyword(s).\n\n**Example:** `easy to use`"},"verified_only":{"type":"boolean","default":false,"description":"Only return reviews written by verified purchasers."},"items_per_page":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Number of reviews to return per page.\n\n**Allowed values:** `1-100`"}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"object","required":["total_reviews","total_pages","current_page","reviews_count","items_per_page","rating","rating_histogram","sort_by","item_id","reviews"],"properties":{"rating":{"type":"number","example":4.33,"nullable":true,"description":"Average overall product rating (0-5). Null when no rating statistics are available."},"item_id":{"type":"string","example":"300569432","description":"The Home Depot internet number the reviews belong to."},"reviews":{"type":"array","items":{"type":"object","required":["review_id","title","review_text","rating","date","last_modified","is_recommended","is_featured","is_verified_purchaser","badges","helpful_count","unhelpful_count","comment_count","author_id","author_name","author_location","images","product_id","original_product_name","merchant_responses","context_data","content_locale","source_client"],"properties":{"date":{"type":"string","example":"2026-05-17T00:38:28.000+00:00","nullable":true,"description":"Review submission timestamp (ISO 8601)."},"title":{"type":"string","example":null,"nullable":true,"description":"Review title. Null when not provided."},"badges":{"type":"array","items":{"type":"string","example":"REVIEW","description":"Badge identifier."},"nullable":true,"description":"Review badges (e.g. verified purchaser, incentivized review). Null when none."},"images":{"type":"array","items":{"type":"string","description":"Photo URL."},"nullable":true,"description":"Reviewer-submitted photo URLs. Null when none."},"rating":{"type":"integer","example":5,"nullable":true,"description":"Star rating given by the reviewer (1-5). Null when not provided."},"author_id":{"type":"string","example":"0312F027B573844E0S","nullable":true,"description":"Reviewer id. Null when anonymous."},"review_id":{"type":"string","example":"301051925","description":"Unique review id."},"product_id":{"type":"string","example":"327469574","nullable":true,"description":"Product id the review is attached to (may be a variant). Null when not provided."},"author_name":{"type":"string","example":"User","nullable":true,"description":"Reviewer nickname. Null when not provided."},"is_featured":{"type":"boolean","example":false,"description":"Whether the review is featured."},"review_text":{"type":"string","example":"Ortho Home Defense Insect Killer is a convenient retail product that effectively kills insects.","nullable":true,"description":"Full review text. Null when not provided."},"context_data":{"type":"object","example":{"EarlyReviewerIncentive":"True"},"nullable":true,"description":"Additional context flags recorded with the review (e.g. incentive flags, variant info). Null when none.","additionalProperties":{"type":"string","description":"Context value."}},"comment_count":{"type":"integer","example":0,"description":"Number of comments on the review."},"helpful_count":{"type":"integer","example":1,"description":"Number of positive (helpful) feedback votes."},"last_modified":{"type":"string","example":"2026-05-27T21:27:45.000+00:00","nullable":true,"description":"Last modification timestamp (ISO 8601)."},"source_client":{"type":"string","example":"homedepot","nullable":true,"description":"Source client that submitted the review."},"content_locale":{"type":"string","example":"en_US","nullable":true,"description":"Review content locale."},"is_recommended":{"type":"boolean","example":null,"nullable":true,"description":"Whether the reviewer recommends the product. Null when the reviewer did not indicate."},"author_location":{"type":"string","example":null,"nullable":true,"description":"Reviewer location. Null when not provided."},"unhelpful_count":{"type":"integer","example":0,"description":"Number of negative (unhelpful) feedback votes."},"merchant_responses":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","nullable":true,"description":"Response date."},"response":{"type":"string","nullable":true,"description":"Response text."},"department":{"type":"string","nullable":true,"description":"Responding department."}}},"nullable":true,"description":"Merchant / client responses to the review. Null when none."},"is_verified_purchaser":{"type":"boolean","example":true,"description":"Whether the reviewer is a verified purchaser."},"original_product_name":{"type":"string","example":"Home Defense Insect Killer for Indoor and Perimeter 2 with Comfort Wand","nullable":true,"description":"Product name as recorded with the review. Null when not provided."}},"description":"A single customer review."},"description":"Reviews on this page."},"sort_by":{"type":"string","example":"helpful","description":"The sort order applied to the reviews."},"total_pages":{"type":"integer","example":701,"description":"Total number of pages available."},"current_page":{"type":"integer","example":1,"description":"The page number returned."},"reviews_count":{"type":"integer","example":20,"description":"Number of reviews returned on this page."},"total_reviews":{"type":"integer","example":14003,"description":"Total number of reviews across all pages."},"items_per_page":{"type":"integer","example":20,"description":"Page size used for this request."},"rating_histogram":{"type":"array","items":{"type":"object","required":["rating","count"],"properties":{"count":{"type":"integer","example":9567,"description":"Number of ratings at this star level."},"rating":{"type":"integer","example":5,"description":"Star level (1-5)."}}},"nullable":true,"description":"Per-star rating counts (always 5 down to 1 when statistics are available). Null when no statistics."},"total_recommended":{"type":"integer","example":2062,"description":"Number of reviewers who recommend the product. Present when statistics are available."},"total_not_recommended":{"type":"integer","example":753,"description":"Number of reviewers who do not recommend the product. Present when statistics are available."}}},"status":{"type":"string","example":"OK","description":"Response status. Always OK on success."},"parameters":{"type":"object","description":"The request parameters as received by the server.","additionalProperties":true},"request_id":{"type":"string","example":"f1e2d3c4-b5a6-9788-7654-321098765432","description":"Unique request identifier (UUID)."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_FcTBomiWvuKkH16JfEwdK","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Fetches paginated customer reviews for a Home Depot product by item ID, including ratings, review text, photos, verified-purchaser status, and star-rating histogram.","exampleAgentPrompt":"Can you pull up the most helpful customer reviews for Home Depot item 300569432, showing only verified purchaser reviews, 20 per page?","exampleUseCases":[{"title":"Researching product quality before purchase","prompt":"I'm thinking of buying Home Depot item 326680222 — can you grab the 20 most helpful verified-purchaser reviews so I can see what real buyers think?"},{"title":"Spotting common complaints in low ratings","prompt":"Can you get the 1-star reviews for Home Depot product 300569432, sorted by newest, so I can see what the most common complaints are?"},{"title":"Finding reviews that mention installation difficulty","prompt":"Search the reviews for Home Depot item 326680222 for anything mentioning 'easy to install' — give me up to 50 results sorted by relevance."}],"resultDescription":"Returns a paginated list of customer reviews including review text, title, star rating (1-5), submission date, author name and location, verified-purchaser status, badges, reviewer-submitted photo URLs, helpful/unhelpful vote counts, merchant responses, and contextual metadata. Also returns product-level statistics: overall average rating, total review count, total pages, current page, and a full 1-5 star rating histogram.","failureModes":["Invalid or non-existent item_id returns empty reviews array or error status","Page number exceeding total_pages returns empty reviews list","No reviews match the specified rating or search_text filter, returning empty array","Service unavailable or upstream Home Depot data source unreachable returns error status","Malformed parameters (e.g. rating out of 1-5 range) may return validation error"],"whenToPreferThis":"Use this endpoint when you need real-time customer review data specifically from Home Depot, including verified-purchaser filtering, keyword search within reviews, star-rating filtering, photo URLs, merchant responses, and a full rating histogram. Prefer this over generic review aggregators when the exact Home Depot item number is known and Home Depot-specific social proof is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:37.369Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-home-depot-product-reviews-aec49dbe"}