Analytics

All analytics endpoints require a valid JWT token with admin scopes.

Overview

Get a summary of wishlist activity over a time period.

GET /v1/analytics/overview?period=30d

Query parameters

Parameter	Default	Description
period	30d	Time period to look back (7d, 14d, 30d, 90d, 1y, all)

Response

{
  "ok": true,
  "data": {
    "totalWishlistedItems": 1482,
    "activeShoppers": 312,
    "wishlistToCartRate": 18.45
  }
}

Field	Description
totalWishlistedItems	Net items added (adds minus removes)
activeShoppers	Unique shoppers who interacted with wishlists
wishlistToCartRate	Percentage of wishlisted items later added to cart

Top products

Get the most wishlisted products.

GET /v1/analytics/top-products?limit=10

Response

{
  "ok": true,
  "data": {
    "products": [
      { "productId": "8012345678", "wishlistCount": 47 },
      { "productId": "8098765432", "wishlistCount": 31 }
    ]
  }
}

Product stats

Get wishlist stats for a specific product.

GET /v1/analytics/product/{productId}

Response

{
  "ok": true,
  "data": {
    "wishlistCount": 47
  }
}

Daily breakdown

Get day-by-day analytics for a time period.

GET /v1/analytics/daily?period=7d

Response

{
  "ok": true,
  "data": {
    "days": [
      {
        "date": "2026-02-15",
        "period": "2026-02-15",
        "items_added": 24,
        "items_removed": 3,
        "unique_shoppers": 18,
        "cumulative_total": 142
      }
    ]
  }
}