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

# Get Review and Rating By Location

> Compare review volume and average rating across business locations.

```
get_review_and_rating_by_location
```

## Description

Returns review count and average rating for each location. Use it to find the highest-rated, lowest-rated, most-reviewed, or least-reviewed branches.

## 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 |
| `sortBy` | string | No | `"avg-rating"` | Sort by `"review-count"`, `"avg-rating"`, or `"name"` |
| `sortOrder` | integer | No | `1` | `0` for ascending or `1` for descending |

## Example Usage

```
Which location had the lowest average rating this year?
```

## Response Fields

| Field | Description |
| - | - |
| `milestone` | Location name |
| `businessId` | Location business number |
| `count` | Review count |
| `rating` | Average rating |
| `state` | Location state |

## Notes

* For the highest or lowest result, choose `sortBy` and `sortOrder` in the tool call and use the first returned location.
* Use [`get_review_and_rating_over_time`](/mcp/tools/reports/get-review-and-rating-over-time) for trends.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.