Get top selling products (analytics)

GET

https://numueg.app/api/v1/stores/{store_id}/analytics/top-products

Last modified:2026-09-19 16:39:33

x-numu-scope:analytics:read

Get top selling products.

Merges top_products_json across daily rollup rows for COMPLETED
days (cheap — at most days rows × ~20 products each) and adds a
live SQL aggregation for today plus any day the nightly task missed.

Today is never read from the rollup: the task writes that row at
03:30 and it would otherwise stay frozen for the rest of the day.
Before this, today had no row at all, so the day's sales contributed
nothing to the product ranking until the following morning.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//analytics/top-products?limit=&days=&start_date=&end_date=&granularity=&tz=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": [
        {
            "id": "string",
            "name": "string",
            "sku": "string",
            "quantity_sold": 0,
            "revenue": 0,
            "percentage": 0
        }
    ],
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Get sales chart data

Get sales by location