Listing analytics
items_post_item_analyticsRead-onlyIdempotent
Retrieve extended statistical metrics for listings over a period, including views, contacts, and presenceSpending. Filter by category or employee, sort by any metric, and group by day, week, month, or item.
Instructions
Returns EXTENDED statistical metrics for the profile/listings over a period (post_item_analytics, stats v2): views, contacts, presenceSpending, etc. with flexible grouping, filters and sorting. Read-only analytics. Choose it over items_post_item_stats_shallow when you need filters by category/employee, sorting by a metric, or presence-spending metrics. limit ≤ 1000.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dateFrom | Yes | Start of the period, inclusive (YYYY-MM-DD). | |
| dateTo | Yes | End of the period, inclusive (YYYY-MM-DD). | |
| metrics | Yes | List of requested metrics (at least 1): views, contacts, presenceSpending, etc. | |
| grouping | Yes | How to group the metrics: period (day|week|month), itemId (by listing) and/or by category. An empty object — overall totals. | |
| limit | Yes | Maximum number of rows in the response (0..1000) for pagination. | |
| offset | Yes | Offset from the start of the selection for pagination (>= 0). | |
| filter | No | Selection filters: categoryIDs — an array of category IDs, employeeIDs — an array of employee IDs. Without the filter — the entire profile. | |
| sort | No | Sorting of results: key — the metric name, order — asc (ascending) or desc (descending). | |
| user_id | No | ID of the owner user. Defaults to Profile_id from .env. |