---
title: "Get customer feedback by period"
method: GET
path: "/dashboard/customer-feedback/by-period"
tags: ["Dashboard"]
---

# Get customer feedback by period

`GET /dashboard/customer-feedback/by-period`

Retrieves customer feedback metrics broken down by time period. Returns average ratings per period, interaction counts (reviews, questions, photos), matched location count, and total ratings. Granularity is auto-determined by the date range. Defaults to all available data (from 1970-01-01 up to today) if startDate is not provided.

## Query parameters

- `v` unknown
- `startDate` string
- `endDate` string
- `group` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY' | 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR'
- `filterCategory` 'location' | 'business' | 'labels' | 'location-groups'
- `textFilter` unknown
- `locationIds` unknown
- `businessIds` unknown
- `labels` unknown
- `locationGroupIds` unknown
- `excludedLocationIds` unknown
- `excludedBusinessIds` unknown
- `excludedLabels` unknown
- `excludedLocationGroupIds` unknown

## Response `200`

Feedback metrics grouped by time period. The interactionCountByPeriod shape depends on the requested version: latest returns counts grouped by type, versions older than 20260713 return the legacy flat list.

- union
  - object — Customer feedback metrics broken down by time period
    - `averageRatingByPeriod` object[], required — Average rating per time period
      - `period` unknown, required
      - `value` unknown, required
    - `granularity` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY', required — Time period granularity. Auto-determined by the date range span unless overridden by the `group` query parameter.
    - `interactionCountByPeriod` object, required — Interaction counts per period grouped by type (reviews, questions, photos)
      - `reviews` object[], required
        - `period` unknown, required
        - `count` unknown, required
      - `questions` object[], required
        - `period` unknown, required
        - `count` unknown, required
      - `photos` object[], required
        - `period` unknown, required
        - `count` unknown, required
    - `matchedLocationsCount` unknown, required
    - `totalRatingCount` unknown, required
    - `isPartialData` unknown, required
  - object — Legacy customer feedback by period response. Returned for API versions older than 20260713, where interactionCountByPeriod is a flat list of review + photo counts per period and periods carry the granularity-dependent labels the monolith used (weekly '2025 3', monthly and quarterly 2025-3, yearly 2025) instead of the ISO period start date.
    - `averageRatingByPeriod` object[], required — Average rating per time period
      - `period` unknown, required
      - `value` unknown, required
    - `granularity` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY', required — Time period granularity
    - `interactionCountByPeriod` object[], required — Combined review and photo interaction count per period (legacy flat format)
      - `period` unknown, required
      - `count` unknown, required
    - `matchedLocationsCount` unknown, required
    - `totalRatingCount` unknown, required
    - `isPartialData` unknown, required

---

[API](https://skmtc.net/uberall/apis/uberall-api.md) · [All operations](https://skmtc.net/uberall/apis/uberall-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uberall/uberall-api/revisions/6e6a85f2b4bd/schema)