---
updatedAt: 2026-03-30T20:47:19.000Z
agentTools:
  projectIndex: https://simplified.readme.io/llms.txt
---

# analytics:range

Get daily time-series metrics for an account over a date range. Useful for charting trends.

## Usage

```bash
simplified analytics:range [options]
```

## Options

| Flag         | Short | Type   | Required | Description                                      |
| ------------ | ----- | ------ | -------- | ------------------------------------------------ |
| `--accounts` | `-a`  | string | ✅        | Account ID                                       |
| `--from`     |       | string | ✅        | Start date `YYYY-MM-DD`                          |
| `--to`       |       | string | ✅        | End date `YYYY-MM-DD` (must be today or earlier) |
| `--metrics`  |       | string |          | Comma-separated metrics to return                |

## Available Metrics

`views` · `reach` · `follower_count` · `impressions` · `engagement` · `likes` · `comments` · `shares`

## Example

```bash
simplified analytics:range \
  -a ACCOUNT_ID \
  --metrics "views,reach,follower_count" \
  --from 2026-03-01 \
  --to 2026-03-31
```

## Response

Returns a JSON array of daily data points:

```json
[
  { "date": "2026-03-01", "views": 420, "reach": 310, "follower_count": 5180 },
  { "date": "2026-03-02", "views": 390, "reach": 280, "follower_count": 5195 }
]
```