Skip to main content
GET
/
screens
/
{screen_id}
/
analytics
Get per-screen analytics
curl --request GET \
  --url https://api.qonversion.io/v4/screens/{screen_id}/analytics \
  --header 'Authorization: Bearer <token>'
{
  "object": "screen_analytics",
  "url": "/v4/screens/scr_abc123/analytics",
  "data": {
    "kpis": {
      "purchases": {
        "value": 42,
        "prev": 38,
        "sparkline": [
          5,
          6,
          5,
          7,
          6,
          6,
          7
        ]
      },
      "trials": {
        "value": 215,
        "prev": 198,
        "sparkline": [
          28,
          31,
          30,
          32,
          31,
          31,
          32
        ]
      },
      "revenue": {
        "value": 840.15,
        "prev": 760.4,
        "sparkline": [
          105,
          118,
          112,
          128,
          120,
          122,
          135.15
        ]
      },
      "refunds": {
        "value": 2,
        "prev": 1,
        "sparkline": [
          0,
          0,
          1,
          0,
          0,
          0,
          1
        ]
      },
      "conversion_rate": {
        "value": 0.195,
        "prev": 0.192,
        "sparkline": [
          0.18,
          0.19,
          0.2,
          0.19,
          0.2,
          0.2,
          0.21
        ]
      },
      "cancel_rate": {
        "value": 0.045,
        "prev": 0.052,
        "sparkline": [
          0.06,
          0.05,
          0.05,
          0.04,
          0.04,
          0.04,
          0.04
        ]
      }
    },
    "period": {
      "from": 1776447033,
      "to": 1777051833,
      "unit": "day"
    },
    "screen": {
      "uid": "scr_abc123",
      "name": "Premium paywall",
      "status": "published",
      "type": "paywall"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Path Parameters

​
screen_id
string
required

Screen identifier.

Maximum string length: 256
Pattern: ^[a-zA-Z0-9._-]+$

Query Parameters

​
from
string

Start of the analytics period (ISO 8601 date or datetime).

Example:

"2025-01-01"

​
to
string

End of the analytics period (ISO 8601 date or datetime).

Example:

"2025-12-31"

​
environment
string

Filter by environment.

​
currency
string

Currency code for revenue metrics (ISO 4217).

Example:

"USD"

​
unit
string

Time unit for grouping analytics data.

Response

Analytics data for the specified screen.

Analytics object wrapped in the standard v4 envelope (object, url, data). data.kpis uses snake_case keys (conversion_rate, cancel_rate) and each KPI carries value, previous-period value, and a sparkline.