Get Review Response Rate By Location

Compare response rates and unanswered-review backlogs across locations.

get_review_response_rate_by_location

Description

Returns response rate, responded count, and unanswered count for each location. Use it for location-level response performance and backlog questions.

Parameters

Parameter	Type	Required	Default	Description
startDate	string	No	All time	Start date in MM/DD/YYYY format
endDate	string	No	All time	End date in MM/DD/YYYY format
reviewSites	list[integer]	No	All sources	Review source IDs to include
ratings	list[integer]	No	All ratings	Star ratings from 0 to 5
businessNumbers	list[integer]	No	All locations	Location IDs to include
compareStartDate	string	No	—	Comparison-period start in MM/DD/YYYY format
compareEndDate	string	No	—	Comparison-period end in MM/DD/YYYY format
order	integer	No	1	0 for ascending or 1 for descending
sortBy	string	No	"rate"	Sort by "rate", "review-count", or "name"
startIndex	integer	No	0	Pagination start index
size	integer	No	100	Locations to return

Example Usage

Which location has the lowest response rate and how many unanswered reviews does it have?

Example Response

{
  "summary": {
    "actual": {
      "totalCount": 187,
      "responseRate": 74,
      "unrespondedRate": 26,
      "unrespondedCount": 49,
      "respondedCount": 138
    },
    "compare": {
      "totalCount": 164,
      "responseRate": 69,
      "unrespondedRate": 31,
      "unrespondedCount": 51,
      "respondedCount": 113
    }
  },
  "dataPoints": [
    {
      "actual": {
        "label": "Acme Dental - Westlake",
        "totalCount": 81,
        "responseRate": 63,
        "unrespondedRate": 37,
        "unrespondedCount": 30,
        "respondedCount": 51,
        "businessNumber": 78902
      },
      "compare": {
        "label": "Acme Dental - Westlake",
        "totalCount": 72,
        "responseRate": 58,
        "unrespondedRate": 42,
        "unrespondedCount": 30,
        "respondedCount": 42,
        "businessNumber": 78902
      }
    }
  ],
  "dataPresent": true
}

Response Fields

summary.actual and summary.compare contain account-wide response metrics. Each dataPoints entry contains an actual and compare object with the location label, businessNumber, total count, response rate, responded count, and unanswered count.

Notes

• For an overall unanswered-review backlog, omit the dates unless the user asks for a specific period.
• The service does not sort by unanswered or responded count. For the worst response performance, use sortBy: "rate" with order: 0 and read unrespondedCount from the returned locations.
• Both comparison dates must be provided together. When neither is supplied, each dataPoints entry (and summary) contains only actual — no compare key at all.
• On accounts with many small locations, a large share of locations can show responseRate: 100 simply because they’ve received very few reviews and answered all of them. Consider a minimum totalCount threshold before surfacing “best/worst responder” results operationally.