API ReferenceSales
Sales per product
GET /rest/v1/sales/products
Best sellers in the range (sort revenue, units or last_sold_at), or the figures of chosen products (product_ids): units, orders, revenue and last_sold_at. Same range rules as GET /sales.
Required scope: orders:read.
Authorization
apiKey AuthorizationBearer <token>
Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Query Parameters
from?string
Format
date-timeto?string
Format
date-timesort?string
Default
"revenue"Value in
- "revenue"
- "units"
- "last_sold_at"
limit?integer
Range
1 <= value <= 100Default
20product_ids?string
Up to 100 comma-separated product ids.
channel_account_id?string
currency?string
Response Body
application/json
application/json
curl -X GET "https://example.com/sales/products"{ "object": "list", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "data": [ { "product_id": "string", "title": "string", "deleted": true, "currency": "string", "units": 0, "orders": 0, "revenue": "string", "last_sold_at": "2019-08-24T14:15:22Z" } ]}Last updated on October 18, 2026
Need help?
Email us and a human replies, usually within one business day.