Sales Analysis and History
The Sales Analysis and History operation (SALES_ANALYSIS_HISTORY) returns traffic, sales, pricing, fee, offer, review and Best Sellers Rank metrics for one Amazon product. Optionally, it adds up to 12 months of history aggregated by week. You identify the product by its asin.
When to use
- Validate demand before sourcing a product by comparing views and purchases over the last 30, 90 and 360 days.
- Estimate conversion by dividing purchases by views for the same period.
- Check whether the current price is stable by comparing it with the 90-day and 360-day average prices.
- Estimate margins with FBA and referral fee data and the product's physical dimensions.
- Chart seasonality and trend changes from the weekly
historyarray (price, BSR, offers, views and purchases).
What the response includes
- Product identity: ASIN, title, brand, category, product type and launch date (
result.product). - Physical data: weight, height, length and units (
result.product.physical). - Traffic and sales: views and purchases for several periods, plus month-over-month and quarter-over-quarter change (
result.product.performance). - Pricing: average prices, offer counts and prices, FBA and referral fees (
result.product.pricing). - Reviews and ranking: review count, average rating, current and average BSR (
result.product.reviews_and_ranking). - Weekly history: one entry per week when
history_rangeis3,6,9or12(result.history[]).
Credit cost
A request costs 5 credits plus 1 credit per requested month of history: 5, 8, 11, 14 or 17 credits for history_range 0, 3, 6, 9 or 12. If the product has no history, only the 5-credit base cost is charged. See the Request page for the full rule and Credit Consumption for all operations.