Feature Usage Analytics

Per-product feature-usage analytics built from your custom SDK events (anything tracked via packedge('pub_key').track('feature_name')). System events (license.*, update.*, release.*, product.*, site.*) are excluded, so you see only your own instrumentation.

GET /v1/products/:id/analytics/feature-usage

Requires a paid plan (402 on the free tier).

Query Parameters

Parameter	Type	Description
from	string	Start date (YYYY-MM-DD); default: last 30 days
to	string	End date, inclusive (YYYY-MM-DD)
event	string	Only event types containing this substring
license_id	string	Only events from one license

Response

{
  "data": {
    "from": "2026-05-13",
    "to": "2026-06-12",
    "totals": {
      "events": 1840,
      "uniqueFeatures": 9,
      "uniqueLicenses": 64,
      "uniqueDomains": 71,
      "activeLicenses": 120
    },
    "topFeatures": [
      {
        "name": "export_pdf",
        "events": 412,
        "priorEvents": 350,
        "licenses": 38,
        "domains": 41,
        "adoptionPct": 31.7,
        "sparkline": [10, 14, 9],
        "sparklineDays": ["2026-06-10", "2026-06-11", "2026-06-12"]
      }
    ],
    "quietFeatures": [
      { "name": "bulk_import", "priorEvents": 22 }
    ],
    "usagePattern": [[0, 1, 3]],
    "topLicenses": [
      {
        "licenseId": "lic_xxx",
        "customerEmail": "[email protected]",
        "events": 120,
        "features": 6
      }
    ],
    "topDomains": [
      { "domain": "customer-site.com", "events": 98 }
    ]
  }
}

Field	Description
topFeatures	Up to 12 features by event count, with prior-window counts, license adoption %, and a daily sparkline.
quietFeatures	Features used in the prior window but silent in the current one.
usagePattern	7×24 heatmap grid (rows = day of week, 0 = Sunday; columns = hour 0–23) of event counts.
topLicenses / topDomains	The heaviest users in the window.

Example

curl -X GET "https://api.packedge.dev/v1/products/prd_xxx/analytics/feature-usage?from=2026-05-01&to=2026-05-31" \
  -H "Authorization: Bearer pk_your_api_key"