Houzz Professional Reviews API Documentation Get public reviews for a Houzz professional, 20 per page by default: rating from 1 to 5, full text, relationship, project date and price, likes, author id and ISO 8601 creation and update times. Pass the user id and professional id from a search result unchanged. An empty page is a successful response.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
4 optional filters available.
string
Required
Houzz user id from a search result. Example: 111882.
1234567890
string
Required
Houzz professional id from a search result. Example: 18124.
1234567890
integer
Optional
Page number, starting at 1. Defaults to 1.
1
integer
Optional
Reviews per page, 1 to 100. Defaults to 20.
10
string
Optional
newest or oldest. Defaults to newest.
relevance
string
Optional
Optional keyword filter.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"total": 114,
"reviews": [
{
"id": "991",
"text": "Fast, clean and fair price.",
"likes": 3,
"rating": 5,
"created_at": "2025-06-20T10:11:12Z",
"project_date": "2025-06-12",
"relationship": "Worked with the pro",
"project_price": 3200
}
],
"has_more": false,
"professional": {
"pro_id": "18124",
"user_id": "111882"
},
"review_count": 114
},
"meta": {
"billable": true,
"endpoint_family": "houzz_reviews"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required query parameter is missing or invalid. This response is not billable.
{
"errors": {
"query": [
"The user_id field is required."
]
},
"message": "The request validation failed"
}Resource Not Found
The requested professional was not found. This response is not billable.
{
"error": {
"code": "NOT_FOUND",
"message": "The requested professional was not found."
},
"success": false
}Invalid Source Response
The upstream answered with a shape that no longer matches the documented contract. This response is not billable.
{
"error": {
"code": "PARSER_DRIFT",
"message": "The API is temporarily unavailable. Please retry."
},
"success": false
}Service Unavailable
The upstream service is temporarily unavailable. Please retry shortly.
{
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.