API reference
Price history
GET/v1/products/{id}/price-history
Retrieve the full price and buy-box timeline for any Walmart product, plus the real category referral fee Walsight tracks for it.
Authentication
All requests are authenticated with a secret API key sent as a Bearer token. Keys are available on the Enterprise plan from your dashboard.
Path parameters
id
string · required
The Walmart product (item) ID, as it appears in the listing URL.
Query parameters
range
string · optional
Time window for the history. One of 1m, 3m, 6m (default) or 12m.
interval
string · optional
Sampling interval — daily or weekly (default).
Response fields
current_price
number
The latest tracked price for the product, in the listed currency.
low_6m
number
Lowest price observed in the last 6 months.
referral_fee
number
Real category-specific referral fee as a decimal (e.g. 0.08 = 8%).
buy_box_owner
string
Current buy-box owner: you, competitor or walmart.
history
array
Time-ordered price points, each with date, price and owner.