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

# Get account insights

> Read account-level metrics for your Instagram professional account.

## Authentication

Use the `hmat_` channel token from `GET /meta/channels/{id}/token` or `hookmyapp channels env <channel>`. Do not use an `hmok_` API key for this call.

```bash theme={null}
Authorization: Bearer hmat_...
```

## Path parameters

<ParamField path="instagramAccountId" type="string" required>
  The connected Instagram account ID.
</ParamField>

## Query parameters

<ParamField query="metric" type="string" required>
  Comma-separated metrics: `reach`, `views`, `likes`, `comments`, `shares`, `saves`, `total_interactions`, `accounts_engaged`, `profile_links_taps`, `follows_and_unfollows`. Demographic metrics `follower_demographics` and `engaged_audience_demographics` are also available — they need `timeframe`, `period=lifetime`, and at least 100 followers.
</ParamField>

<ParamField query="period" type="string" required>
  Aggregation period, e.g. `day`.
</ParamField>

<ParamField query="metric_type" type="string">
  Pass `total_value` whenever you request total-value metrics such as `views`, `likes`, `comments`, `shares`, `saves`, `total_interactions`, or `accounts_engaged` — Meta rejects those metrics without it. Metrics that support a time series (such as `reach`) work without it and return per-period values instead.
</ParamField>

<ParamField query="breakdown" type="string">
  For supported interaction metrics: `follow_type`, `media_product_type`, or `contact_button_type`. For the demographic metrics (`follower_demographics`, `engaged_audience_demographics`), pass a demographic dimension instead — `age`, `city`, `country`, or `gender` — together with `metric_type=total_value`; Meta rejects a demographics call without one.
</ParamField>

<ParamField query="timeframe" type="string">
  Required for demographic metrics: `last_14_days`, `last_30_days`, `last_90_days`, `prev_month`, or `this_month`.
</ParamField>

See [Insights](/instagram/insights) for metric definitions and data caveats (48-hour lag, values under 5 withheld).

## Example

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/{INSTAGRAM_ACCOUNT_ID}/insights?metric=reach,views&period=day&metric_type=total_value" \
  -H "Authorization: Bearer hmat_..."
```

## Successful response

```json theme={null}
{
  "data": [
    {
      "name": "reach",
      "period": "day",
      "total_value": { "value": 1250 },
      "id": "17841400000000000/insights/reach/day"
    }
  ]
}
```