Appearance
Insights
Overview
Insights is the platform's personal analytics view. It gives each user a snapshot of how their collection is growing and how their social activity is performing, across three time horizons: the last 7 days, the last 30 days, and the last 12 months. All data is calculated automatically and is always current — there is nothing to configure or edit.
Metrics
Insights cover two categories of metrics.
Engagement metrics — based on activity on the user's posts:
| Metric | What it measures |
|---|---|
| Likes | Likes received on the user's posts |
| Comments | Comments received on the user's posts |
| Chains | Times the user's posts have been chained by others |
| Followers | Users currently following this user |
Collection metrics — based on the user's cards:
| Metric | What it measures |
|---|---|
| Cards | Total number of cards in the user's collection |
| Costs | Total net acquisition cost across the user's collection |
| Categories | Total categories in use, with a breakdown of how many cards belong to each |
| Showrooms | Number of showrooms that include at least one of the user's cards |
Each metric reports a total count plus three time-series breakdowns:
| Period | Granularity | Length |
|---|---|---|
| Week | One value per day | Last 7 days |
| Month | One value per day | Last 30 days |
| Year | One value per calendar month | Last 12 months |
Relations
Business Rules
- Insights are read-only — they are calculated from existing platform data and cannot be edited or deleted.
- A user can only view their own insights; cross-user access is not supported.
- Engagement metrics are scoped to the user's own posts: likes, comments, and chains are counted only on posts the user owns.
- The followers metric counts users currently following the insight owner.
- Collection metrics are scoped to cards currently owned by the user.
- The costs metric sums the net acquisition costs recorded across all owned cards.
- The category distribution shows how many cards belong to each of the user's categories.
- The showrooms metric counts distinct showrooms that contain at least one of the user's cards.
- Each time-series breakdown is relative to the moment the request is made — the week series covers the 7 most recent days, the month series the 30 most recent days, and the year series the 12 most recent calendar months.
Constraints
- Insights require authentication. Unauthenticated requests are rejected.
- All metric data is scoped to the authenticated user — it is not possible to retrieve another user's insights.