# analytics_topics_retrieve

Endpoint: GET /api/analytics/topics/
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)
    * overview - Overall topic metrics
* sessions - Sessions over time
* ratings - Ratings over time
* highlighted - Highlighted topics
    Enum: "overview", "sessions", "ratings", "highlighted"

  - `platform_key` (string)

  - `start_date` (string)

## Response 200 fields (application/json):

  - `topics` (object, required)
    Topic metrics including all-time, monthly counts and percentage change

  - `topics.all_time_total` (integer, required)
    Total count since the beginning of time

  - `topics.this_month` (integer, required)
    Count for current month

  - `topics.last_month` (integer, required)
    Count for previous month

  - `topics.percentage_change` (number, required)
    Percentage change from last month to this month

  - `sessions` (object, required)
    Session metrics including all-time, monthly counts and percentage change

  - `conversations` (object, required)
    Conversation metrics including all-time, monthly counts and percentage change

  - `messages` (object, required)
    Message metrics including all-time, monthly counts and percentage change