About the Wix Assistant Statistics API

The Wix Assistant Statistics API provides read-only access to aggregated analytics data for AI Site-Chat interactions on a site. Use this API to monitor chat performance, track visitor engagement, and analyze how AI Site-Chat contributes to product discovery and support outcomes.

With this API, you can:

• Retrieve daily KPI data for the last 30 days.
• Access period KPI data comparing the last 30 days with the previous 30 days.
• Request only the KPI fields your app needs.
• Monitor metrics such as conversations, visitors, product exposures, orders, replied conversations, and response times.
• Build custom analytics dashboards for AI Site-Chat performance monitoring.

Before you begin

It's important to note the following points before starting to code:

• The API is read-only and provides no ability to modify or delete statistics data.
• Statistics are scoped to the authenticated site. You don't specify a site ID in the request.
• Daily KPI data is returned for up to 30 days.
• Period KPI data is returned for predefined comparison periods.
• When you don't pass dailyFields or byPeriodFields, the response includes the default KPI field sets.
• Deprecated typed fields may be present for backward compatibility. Use dailyKpis and periodKpis for new integrations.

Use cases

The following use cases are supported:

• Monitor AI Site-Chat performance metrics
• Build analytics dashboards for chat engagement
• Compare current and historical chat performance

KPI fields

Default daily KPI fields include:

• kpi_date
• mode
• conversations_count
• visitors_distinct_count
• exposed_items_count
• total_orders_count
• replied_conversations_count
• response_time_seconds_p50
• first_response_time_seconds_p50

Default period KPI fields include:

• period
• mode
• conversations_count
• visitors_distinct_count
• exposed_items_count
• total_orders_count
• replied_conversations_count
• response_time_seconds_p50
• first_response_time_seconds_p50

Terminology

• Daily KPI: Key performance indicators aggregated by day for the authenticated site.
• Period KPI: Aggregated statistics for predefined comparison periods.
• Conversations: Individual chat sessions between visitors and the AI assistant.
• Visitors: Unique site visitors who engaged with the AI Site-Chat feature.
• Exposed items: Product items that were shown or recommended to visitors during chat interactions.
• Orders: Orders associated with AI Site-Chat activity.
• Replied conversations: Conversations that received a response.
• Response time: Median response-time KPI values, returned in seconds. Common fields include response_time_seconds_p50 and first_response_time_seconds_p50.
• last_30_days: Rolling 30-day period from the current date.
• previous_30_days: The 30-day period immediately before the last 30 days, used for comparison.