---
title: "Weekly review analytics snapshot"
method: POST
path: "review_analytics.weekly_snapshot"
tags: ["Webhooks/Webhooks", "Webhooks"]
---

# Weekly review analytics snapshot

`POST review_analytics.weekly_snapshot` (webhook)

**Event name:** `review_analytics.weekly_snapshot`

The weekly review-analytics roll-up for a location. Scope: location-scoped. Delivered as a signed HTTP POST to your Webhooks URL.

## Headers

- `X-Synup-Signature` string, required

## Payload

- object
  - `event` string: Dotted event name.
  - `timestamp` string: ISO-8601 UTC time the event was emitted.
  - `account_id` integer: Synup account the event belongs to.
  - `location_id` string: Numeric string for location-scoped events; null for brand-scoped events.
  - `data` object
    - `period` string: Period start, YYYY-MM-DD.
    - `granularity` string: "daily" or "weekly".
    - `total_reviews` integer: All-time total review count for the location.
    - `new_reviews_in_period` integer: New reviews received during this period.
    - `average_rating` number: Average star rating this period (4-dp float; 0.0 if none).
    - `previous_average_rating` number: Average rating for the preceding period.

## Acknowledgement `200`

Your endpoint acknowledges receipt with any 2xx. A non-2xx response or a timeout (>10s) is treated as a failed delivery.

- object

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)