Top products [+]
Products
Top products [+]
Your best sellers ranked by revenue within a period.
GET
Top products [+]
Products ranked by completed-sale revenue within the period, with order counts, the “best sellers” list from the dashboard.
Tier: Premium, requires a premium key and an active Branding+ subscription (checked on every request).
Request
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
period | string | thisMonth | Calendar periods (today, thisWeek, thisMonth, thisYear) or rolling windows (last7d, last30d, last90d). |
limit | integer | 10 | Number of products to return, max 50. |
Response
| Field | Description |
|---|---|
items[] | Sorted by revenue, highest first. |
items[].product | null when the product was deleted after the sales happened, the revenue still counts. |
items[].revenue | Net revenue in USD dollars (number). |
Errors
| HTTP | Code | When |
|---|---|---|
| 403 | PREMIUM_KEY_REQUIRED | The key is basic-tier. |
| 403 | SUBSCRIPTION_INACTIVE | Premium key, but the Branding+ subscription is no longer active. |