Get Review Count By Source

Break down review volume by source for each location.

get_review_count_by_source

Description

Returns review counts from Google, Yelp, Facebook, Birdeye, and other sources for each location.

Parameters

Parameter	Type	Required	Default	Description
startDate	string	No	—	Start date in MM/DD/YYYY format
endDate	string	No	—	End date in MM/DD/YYYY format
days	integer	No	—	Relative window in days
months	integer	No	12 months when no period is requested	Relative window in months
sourceAliases	list[string]	No	All sources	Review sources to include
businessNumbers	list[integer]	No	All locations	Location IDs to include

Example Usage

How many Google versus Yelp reviews did each location receive this year?

Example Response

[
  {
    "count": 342,
    "milestone": "Acme Dental - Downtown",
    "businessId": 78901,
    "reviewSites": [
      { "sourceAlias": "google", "count": 248 },
      { "sourceAlias": "yelp", "count": 39 },
      { "sourceAlias": "birdeye", "count": 55 }
    ]
  }
]

Response Fields

Each location contains milestone for the location name, businessId, total count, and reviewSites entries with sourceAlias and count.

Notes

• milestone contains the location name, not a date or reporting period.
• sourceAlias values are lowercase machine identifiers ("google", "our_website", "direct_feedback", etc.), not display names — confirmed in testing.
• count is the location total across the returned sources; do not add it to the individual reviewSites counts.
• Sources with zero reviews in the window are simply absent from reviewSites rather than listed with count: 0.
• Use businessNumbers to restrict the report to location IDs returned by get_child_locations. On accounts with many locations, an unscoped call over a wide window can return a very large array — a short window (e.g. days: 7) or businessNumbers keeps the response manageable.