> ## Documentation Index
> Fetch the complete documentation index at: https://birdeye-0229a3ce-responsetools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Review Count By Rating

> View the distribution of reviews across star ratings.

```
get_review_count_by_rating
```

## Description

Returns the total review count and a breakdown for ratings from 0 through 5. Use it to understand the overall rating distribution or focus on negative and positive review volume.

## Parameters

| Parameter         | Type           | Required | Default       | Description                                                        |
| ----------------- | -------------- | -------- | ------------- | ------------------------------------------------------------------ |
| `fromDate`        | string         | No       | —             | Start date in `MM/DD/YYYY` format                                  |
| `toDate`          | string         | No       | —             | End date in `MM/DD/YYYY` format                                    |
| `sourceAlias`     | list\[string]  | No       | All sources   | Sources such as `"google"`, `"yelp"`, `"facebook"`, or `"birdeye"` |
| `businessNumbers` | list\[integer] | No       | All locations | Location IDs to include                                            |

## Example Usage

```
How many 1-star, 2-star, and 5-star Google reviews did we receive this year?
```

## Example Response

```json theme={null}
{
  "reviewCount": 342,
  "countByRating": [
    { "rating": 0, "count": 12 },
    { "rating": 1, "count": 9 },
    { "rating": 2, "count": 16 },
    { "rating": 3, "count": 31 },
    { "rating": 4, "count": 96 },
    { "rating": 5, "count": 178 }
  ]
}
```

## Response Fields

The response contains `reviewCount` and `countByRating` entries with `rating` and `count`.

## Notes

* Rating `0` represents Facebook recommended and non-recommended reviews without a star value. It does not mean zero stars.
* `reviewCount` counts only reviews that carry a rating value. It can be somewhat lower than the review totals reported by other tools (for example the response-rate and NPS reports), which count all reviews including some without a rating — don't expect exact parity across tools when cross-checking totals.