---
title: "website_engagement_stats. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/website_engagement_stats
description: "Website visitor engagement metrics: session data, page views, visitor behavior analytics. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# website_engagement_stats

Website visitor engagement metrics: session data, page views, visitor behavior analytics.

Read [analytics](https://metadata.io/developers/tools/#cat-analytics)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `dateRange` | string | required | Timeframe for engagement data. Options: YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_MONTH, MONTH_TO_DATE (default), LIFETIME. REQUIRED parameter.one of: `YESTERDAY`, `LAST_7_DAYS`, `LAST_14_DAYS`, `LAST_30_DAYS`, `LAST_MONTH`, `MONTH_TO_DATE`, `LIFETIME` |
| `page` | integer |   | Page number for pagination (0-based). Example: page=0 for the first page. |
| `size` | integer |   | Number of results per page. Default: 15; raise it (up to 10000) to pull the full engagement set in one call. |
| `sort` | string |   | Sorting criteria. Examples: 'sessions,desc' (default), 'pageViews,desc', 'uniqueVisitors,desc', 'conversionRate,desc'. Format: field,direction where direction is 'asc' or 'desc'. |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

Recorded with these arguments. Enum values are the first the tool's own schema declares; ids were fetched live from a `list_` call immediately before.

Real, from the production server, in **539 ms**. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

## Related

Other analytics tools:

- [account_funnel_reports](https://metadata.io/developers/tools/account_funnel_reports) Read
- [account_level_stats](https://metadata.io/developers/tools/account_level_stats) Read
- [account_list_performance](https://metadata.io/developers/tools/account_list_performance) Read
- [budget_group_performance](https://metadata.io/developers/tools/budget_group_performance) Read
- [deep_funnel_stats](https://metadata.io/developers/tools/deep_funnel_stats) Read
- [demographic_country_stats](https://metadata.io/developers/tools/demographic_country_stats) Read
- [experiment_performance_stats](https://metadata.io/developers/tools/experiment_performance_stats) Read
- [get_account_opportunities_insights](https://metadata.io/developers/tools/get_account_opportunities_insights) Read

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)