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?days=30

Query parameters

Parameter	Default	Description
days	30	Number of days to look back

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?days=7

Response

{
  "ok": true,
  "data": {
    "days": [
      {
        "date": "2026-02-15",
        "itemsAdded": 24,
        "itemsRemoved": 3,
        "uniqueShoppers": 18,
        "addToCartFromWishlist": 5
      }
    ]
  }
}