# analytics_ratings_retrieve

Ratings overtime endpoint.

Query params:
- metric: only 'ratings' is supported (default)
- platform_key, mentor_unique_id: optional filters
- granularity: 'day' (default) or 'hour' (hour only for today)
- start_date, end_date: optional date range; defaults applied if not provided

Returns: { metric: 'ratings', points: [{date, value}, ...] }

Endpoint: GET /api/analytics/ratings/
Version: 4.84.1-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `date_filter` (string)
    * today - Today only
* 7d - Last 7 days
* 30d - Last 30 days
* 90d - Last 90 days
* all_time - All time
* custom - Custom date range
    Enum: "today", "7d", "30d", "90d", "all_time", "custom"

  - `end_date` (string)

  - `granularity` (string)
    * day - day
* hour - hour
* week - week
* month - month
    Enum: "day", "hour", "week", "month"

  - `mentor_unique_id` (string)

  - `metric` (string)
    * ratings - Ratings over time
    Enum: "ratings"

  - `platform_key` (string)

  - `start_date` (string)

## Response 200 fields (application/json):

  - `metric` (string, required)

  - `points` (array, required)

  - `points.date` (string, required)

  - `points.value` (number, required)
    Average rating value for this time period