> ## Documentation Index
> Fetch the complete documentation index at: https://docs.birdeye.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Competitor Review Metrics

> Retrieve aggregated average rating and review count per competitor location and source.

```
retrieve_competitor_review_metrics
```

## Description

Returns aggregated review metrics for competitor locations — average rating and total review count grouped by competitor location and review source. Use this for a quick competitive benchmark without fetching full review content.

Each metric record includes:

* `businessLocations` — your business locations associated with this competitor (businessId, name, alias, businessNumber, phone, address)
* `competitorLocation` — the competitor location name
* `competitorBrand` — the competitor brand name
* `source` — review platform (e.g. `"Google"`, `"Yelp"`)
* `overallRating` — average star rating for this competitor location on this source
* `reviewCount` — total number of reviews for this competitor location on this source

## Parameters

### Required

| Parameter | Type | Description |
| - | - | - |
| `startDate` | string (`MM/DD/YYYY`) | Start of the date range |
| `endDate` | string (`MM/DD/YYYY`) | End of the date range |

### Optional

| Parameter | Type | Default | Description |
| - | - | - | - |
| `startIndex` | integer | `0` | 0-based start index for pagination |
| `pageSize` | integer | `25` | Records per page (max 100) |
| `sortOrder` | integer | `0` | `0` = ascending (default), `1` = descending |
| `businessNumbers` | list\[integer] | — | Scope to specific enterprise location numbers (from [`get_child_locations`](/mcp/tools/business/get-child-locations)) |
| `sources` | list\[string] | — | Filter by review source (e.g. `["google"]`) |
| `brandIds` | list\[integer] | — | Filter by specific competitor brand IDs (max 5) |
| `competitorLocationIds` | list\[integer] | — | Filter by specific competitor location IDs |

## Example Usage

```
How does my average rating compare to competitors?
```

```
Which competitor has the most Google reviews?
```

```
Show competitor review counts by source for last quarter.
```

```
Show competitor review metrics for my Austin location.
```

## Notes

* To scope by location name, call [`get_child_locations`](/mcp/tools/business/get-child-locations) first, match the location by `name`/`alias`, then pass its `businessNumber` in `businessNumbers`.
* Maximum 5 `brandIds` per request.


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