> ## 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 Visitor Count

> Measure business visitors by traffic source and location.

```
get_visitor_count
```

## Description

Returns audience reach from review sites, websites, and social channels. This tool measures views and visits, not review volume.

## 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                           | Traffic sources to include        |
| `businessNumbers` | list\[integer] | No       | All locations                         | Location IDs to include           |

## Example Usage

```
Which location received the most visitors last month, and where did the traffic come from?
```

## Example Response

```json theme={null}
[
  {
    "count": 315,
    "milestone": "Acme Dental - Downtown",
    "businessId": 78901,
    "visitors": [
      { "sourceAlias": "Facebook", "count": 18 },
      { "sourceAlias": "Google", "count": 172 },
      { "sourceAlias": "Review Site", "count": 74 },
      { "sourceAlias": "Website", "count": 51 },
      { "sourceAlias": "Total", "count": 315 }
    ]
  }
]
```

## Response Fields

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

## Notes

* The `Total` visitor entry is already a rollup. Do not add it to the individual source rows.
* `businessId` can be `null` even when `milestone` (the location name) is present — confirmed in testing on locations with zero visitor activity in the window. Don't assume `businessId` is always populated.
* On accounts with many locations, an unscoped call can return a very large array (one entry per location, including locations with zero visitors). Pass `businessNumbers` to keep the response manageable.