Products
List Product Snapshots
Historical data collected for a product
GET
Product ID
Number of days of history (max: 90)
Page number
Results per page (max: 100)
Description
Returns the full snapshot history for a product. Each snapshot contains the structured data collected: price, stock, rating, ranking and promotions.Object structure
price
| Field | Type | Description |
|---|---|---|
current | float | Current price |
original | float | Strikethrough price (before promo) |
range | string | Price range |
currency | string | Currency (USD) |
stock
| Field | Type | Description |
|---|---|---|
available | boolean | In stock |
label | string | Availability label |
rating
| Field | Type | Description |
|---|---|---|
value | float | Average rating |
count | integer | Review count |
rank
| Field | Type | Description |
|---|---|---|
position | integer | Position within the category |
page | integer | Page number |
page_size | integer | Products per page |
promo
| Field | Type | Description |
|---|---|---|
text | string | Discount text (“-20%”, “-1.00”) |
slug | string | Offer identifier |
type | string | Promo type (“percentage”, “amount”) |
badge | string | Displayed badge (“Promotion”, “Offer”) |
loyalty | object | Loyalty program info (if applicable) |