Get Review Count By Source - Birdeye Developer Portal

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.
count is the location total across the returned sources; do not add it to the individual reviewSites counts.
Use businessNumbers to restrict the report to location IDs returned by get_child_locations.