Sales Analysis and History Response

The result object contains a product object with current metrics for the requested ASIN and a history array with weekly data points. Every response uses the shared response envelope (request_info, request_parameters, request_metadata, result).

Response structure

result
├── product                  object: identity and current metrics
│   ├── asin, main_asin, marketplace, name, brand, category, currency
│   ├── age, image_url, launch_date, is_exact_match
│   ├── product_type, product_type_id, gl_product_group, gl_product_group_desc
│   ├── physical             object: weight and dimensions
│   ├── performance          object
│   │   ├── traffic          object: views and change rates
│   │   └── sales            object: purchases
│   ├── pricing              object
│   │   ├── offers           object: offer count, depth and price range
│   │   └── fees             object: FBA and referral fees
│   └── reviews_and_ranking  object
│       ├── reviews          object: review count and rating
│       └── ranking          object: Best Sellers Rank
└── history[]                array: one entry per week

Result fields

`result.product`

Field	Type	Description
`asin`	string	The requested ASIN.
`main_asin`	string	ASIN with a marketplace suffix, for example `B07C2Z21X5-US`.
`marketplace`	string	Two-letter marketplace country code, for example `US`.
`name`	string	Product title.
`brand`	string	Brand name.
`category`	string	Category path separated by `/`, for example `Camera & Photo/Digital Cameras/DSLR Cameras`.
`currency`	string	ISO currency code of the price and fee values, for example `USD`.
`age`	number	Product age in years, calculated from `launch_date`.
`image_url`	string	File name of the main image, for example `41ZurL2c2rL.jpg`. Not a full URL.
`launch_date`	string	ISO 8601 date when the product was first listed.
`is_exact_match`	boolean	`true` when the data matches the requested ASIN exactly.
`product_type`	string	Amazon product type, for example `CAMERA_DIGITAL`.
`product_type_id`	integer	Numeric ID of the product type.
`gl_product_group`	integer	Amazon General Ledger (GL) product group ID.
`gl_product_group_desc`	string	GL product group name, for example `gl_camera`.
`physical`	object	Weight and dimensions. See `result.product.physical`.
`performance`	object	Traffic and sales metrics. See `result.product.performance`.
`pricing`	object	Prices, offers and fees. See `result.product.pricing`.
`reviews_and_ranking`	object	Reviews and Best Sellers Rank. See `result.product.reviews_and_ranking`.

`result.product.physical`

Field	Type	Description
`weight`	string	Product weight as a numeric string, for example `1.04`.
`weight_unit`	string	Unit of `weight`, for example `pounds`.
`height`	string	Height as a numeric string.
`length`	string	Length as a numeric string.
`dimension_unit`	string	Unit of `height` and `length`, for example `inches`.

`result.product.performance`

Field	Type	Description
`traffic.total_views`	integer	Total views reported for the product.
`traffic.views_last_30_days`	integer	Views in the last 30 days.
`traffic.views_previous_30_days`	integer	Views in the 30 days before that.
`traffic.views_last_90_days`	integer	Views in the last 90 days.
`traffic.views_previous_90_days`	integer	Views in the 90 days before that.
`traffic.views_last_360_days`	integer	Views in the last 360 days.
`traffic.month_over_month_change`	number	Change of `views_last_30_days` against `views_previous_30_days`, as a fraction. `0.088` means +8.8%.
`traffic.quarter_over_quarter_change`	number	Change of `views_last_90_days` against `views_previous_90_days`, as a fraction. `-0.049` means -4.9%.
`sales.purchases_last_30_days`	integer	Units purchased in the last 30 days.
`sales.purchases_last_90_days`	integer	Units purchased in the last 90 days.
`sales.purchases_last_360_days`	integer	Units purchased in the last 360 days.

`result.product.pricing`

Field	Type	Description
`average_price_last_90_days`	number	Average Buy Box price over the last 90 days.
`average_price_last_360_days`	number	Average Buy Box price over the last 360 days.
`offers.total_offers_last_90_days`	integer	Number of offers seen in the last 90 days.
`offers.new_offer_average_depth`	number	Average stock quantity (inventory depth) of offers in New condition.
`offers.new_offer_min_price`	number	Lowest price observed for New condition.
`offers.new_offer_max_price`	number	Highest price observed for New condition.
`fees.fba_fee_last_360_days`	number	FBA fulfillment fee, based on the last 360 days.
`fees.referral_fee_last_360_days`	number	Referral (commission) fee, based on the last 360 days.

`result.product.reviews_and_ranking`

Field	Type	Description
`reviews.total_count`	integer	Total number of reviews.
`reviews.average_rating`	number	Average star rating, from `0` to `5`.
`ranking.current_rank`	integer	Current Best Sellers Rank (BSR).
`ranking.average_rank`	number	Average BSR over time. Can have decimals, for example `62.4333`.
`ranking.category`	string	Category the rank applies to, for example `DSLR Cameras`.

`result.history[]`

Each entry covers one week. Weekly entries are returned when history_range is 3, 6, 9 or 12; with 0 (the default) no weekly history is returned. The samples list weeks newest first.

Field	Type	Description
`date`	string	ISO 8601 start date of the week.
`views`	integer	Views during the week.
`purchases`	integer	Units purchased during the week.
`average_price`	number	Average selling price during the week.
`total_offers`	integer	Number of active offers (sellers) on the listing during the week.
`best_seller_rank`	integer	BSR position during the week.
`review_count`	integer	Number of new reviews added during the week. Can be `0`.
`review_rating`	number	Average rating of the reviews added during the week. Can be `0`.

Sample response

Sample response (SALES_ANALYSIS_HISTORY, .com, history_range=12)

This sample shows request_parameters and result only; request_info and request_metadata are left out.

{
  "request_parameters": {
    "output": "json",
    "language": "en_US",
    "include_html": false,
    "asin": "B00KTLXB4C",
    "history_range": 12,
    "type": "SALES_ANALYSIS_HISTORY"
  },
  "result": {
    "product": {
      "asin": "B00KTLXB4C",
      "main_asin": "B00KTLXB4C-US",
      "marketplace": "US",
      "name": "NIVEA Cocoa Butter Body Lotion for Dry Skin with Hyaluronic Acid Cocoa Butter and Deep Nourishing Serum 72-Hour Body Moisturizer 16.9 Fl Oz Pump Bottle",
      "brand": "NIVEA",
      "category": "Skin Care/Body/Moisturizers",
      "currency": "USD",
      "age": 12.5,
      "image_url": "31HrjBfavoL.jpg",
      "launch_date": "2014-06-20T00:00:00.000Z",
      "is_exact_match": true,
      "product_type": "SKIN_MOISTURIZER",
      "product_type_id": 40210,
      "gl_product_group": 194,
      "gl_product_group_desc": "gl_beauty",
      "physical": {
        "weight": "1.05625",
        "weight_unit": "pounds",
        "height": "9.449",
        "length": "3.268",
        "dimension_unit": "inches"
      },
      "performance": {
        "traffic": {
          "total_views": 214520,
          "views_last_30_days": 27344,
          "views_last_90_days": 53219,
          "views_last_360_days": 214520,
          "views_previous_30_days": 10680,
          "views_previous_90_days": 55994,
          "month_over_month_change": 1.560299625468165,
          "quarter_over_quarter_change": -0.049558881308711666
        },
        "sales": {
          "purchases_last_30_days": 7944,
          "purchases_last_90_days": 15461,
          "purchases_last_360_days": 62322
        }
      },
      "pricing": {
        "average_price_last_90_days": 15.822184,
        "average_price_last_360_days": 16.189751,
        "offers": {
          "total_offers_last_90_days": 42,
          "new_offer_average_depth": 0,
          "new_offer_max_price": 20.98,
          "new_offer_min_price": 5.29
        },
        "fees": {
          "fba_fee_last_360_days": 5.308633,
          "referral_fee_last_360_days": 1.908284
        }
      },
      "reviews_and_ranking": {
        "reviews": {
          "total_count": 4360,
          "average_rating": 4.8
        },
        "ranking": {
          "current_rank": 32,
          "category": "Lotions",
          "average_rank": 62.4333
        }
      }
    },
    "history": [
      {"date":"2025-12-28T00:00:00.000Z","views":10674,"purchases":3100,"average_price":7.03980291549678,"total_offers":14,"review_count":0,"review_rating":0,"best_seller_rank":62},
      {"date":"2025-12-21T00:00:00.000Z","views":12139,"purchases":3526,"average_price":7.06456463987599,"total_offers":14,"review_count":0,"review_rating":0,"best_seller_rank":100},
      {"date":"2025-12-14T00:00:00.000Z","views":5855,"purchases":1700,"average_price":7.0894908394917,"total_offers":14,"review_count":0,"review_rating":0,"best_seller_rank":99},
      {"date":"2025-12-07T00:00:00.000Z","views":7030,"purchases":2042,"average_price":7.1056421706698,"total_offers":14,"review_count":0,"review_rating":0,"best_seller_rank":100},
      {"date":"2025-11-30T00:00:00.000Z","views":2320,"purchases":674,"average_price":7.10407586305013,"total_offers":15,"review_count":0,"review_rating":0,"best_seller_rank":98},
      {"date":"2025-11-23T00:00:00.000Z","views":3022,"purchases":877,"average_price":7.10726820153393,"total_offers":16,"review_count":0,"review_rating":0,"best_seller_rank":94},
      {"date":"2025-11-16T00:00:00.000Z","views":2299,"purchases":667,"average_price":7.12035828907296,"total_offers":17,"review_count":0,"review_rating":0,"best_seller_rank":93},
      {"date":"2025-11-09T00:00:00.000Z","views":2723,"purchases":791,"average_price":7.13451387274069,"total_offers":39,"review_count":0,"review_rating":0,"best_seller_rank":91},
      {"date":"2025-11-02T00:00:00.000Z","views":2636,"purchases":765,"average_price":7.14527491716026,"total_offers":39,"review_count":0,"review_rating":0,"best_seller_rank":91},
      {"date":"2025-10-26T00:00:00.000Z","views":3057,"purchases":888,"average_price":7.14204467542168,"total_offers":39,"review_count":0,"review_rating":0,"best_seller_rank":90},
      {"date":"2025-10-19T00:00:00.000Z","views":4327,"purchases":1257,"average_price":7.12970403311437,"total_offers":39,"review_count":0,"review_rating":0,"best_seller_rank":90},
      {"date":"2025-10-12T00:00:00.000Z","views":4513,"purchases":1311,"average_price":7.15239752572346,"total_offers":40,"review_count":0,"review_rating":0,"best_seller_rank":94},
      {"date":"2025-10-05T00:00:00.000Z","views":3298,"purchases":958,"average_price":7.18949135064269,"total_offers":39,"review_count":0,"review_rating":0,"best_seller_rank":95},
      {"date":"2025-09-28T00:00:00.000Z","views":3804,"purchases":1105,"average_price":7.17749834628261,"total_offers":37,"review_count":0,"review_rating":0,"best_seller_rank":95},
      {"date":"2025-09-21T00:00:00.000Z","views":4080,"purchases":1185,"average_price":7.17490588418662,"total_offers":36,"review_count":0,"review_rating":0,"best_seller_rank":61},
      {"date":"2025-09-14T00:00:00.000Z","views":3934,"purchases":1142,"average_price":7.17155574447536,"total_offers":37,"review_count":0,"review_rating":0,"best_seller_rank":61},
      {"date":"2025-09-07T00:00:00.000Z","views":4296,"purchases":1248,"average_price":7.16922136143859,"total_offers":37,"review_count":0,"review_rating":0,"best_seller_rank":62},
      {"date":"2025-08-31T00:00:00.000Z","views":4062,"purchases":1180,"average_price":7.16581579638703,"total_offers":37,"review_count":0,"review_rating":0,"best_seller_rank":62},
      {"date":"2025-08-24T00:00:00.000Z","views":4261,"purchases":1237,"average_price":7.16400266601491,"total_offers":36,"review_count":0,"review_rating":0,"best_seller_rank":62},
      {"date":"2025-08-17T00:00:00.000Z","views":3817,"purchases":1108,"average_price":7.15544638238112,"total_offers":36,"review_count":0,"review_rating":0,"best_seller_rank":61},
      {"date":"2025-08-10T00:00:00.000Z","views":4020,"purchases":1167,"average_price":7.15405226045491,"total_offers":37,"review_count":0,"review_rating":0,"best_seller_rank":60},
      {"date":"2025-08-03T00:00:00.000Z","views":4427,"purchases":1286,"average_price":7.1500144822202,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":60},
      {"date":"2025-07-27T00:00:00.000Z","views":3605,"purchases":1047,"average_price":7.14546464990856,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":60},
      {"date":"2025-07-20T00:00:00.000Z","views":3368,"purchases":978,"average_price":7.1429808704135,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":60},
      {"date":"2025-07-13T00:00:00.000Z","views":4420,"purchases":1284,"average_price":7.13303605239917,"total_offers":40,"review_count":0,"review_rating":0,"best_seller_rank":58},
      {"date":"2025-07-06T00:00:00.000Z","views":3967,"purchases":1152,"average_price":7.12771981576516,"total_offers":40,"review_count":0,"review_rating":0,"best_seller_rank":56},
      {"date":"2025-06-29T00:00:00.000Z","views":3933,"purchases":1142,"average_price":7.12323812770671,"total_offers":40,"review_count":0,"review_rating":0,"best_seller_rank":55},
      {"date":"2025-06-22T00:00:00.000Z","views":4410,"purchases":1281,"average_price":7.1153055533838,"total_offers":40,"review_count":0,"review_rating":0,"best_seller_rank":55},
      {"date":"2025-06-15T00:00:00.000Z","views":4464,"purchases":1296,"average_price":7.10853183248893,"total_offers":39,"review_count":0,"review_rating":0,"best_seller_rank":54},
      {"date":"2025-06-08T00:00:00.000Z","views":3962,"purchases":1151,"average_price":7.09732810962075,"total_offers":40,"review_count":0,"review_rating":0,"best_seller_rank":54},
      {"date":"2025-06-01T00:00:00.000Z","views":3743,"purchases":1087,"average_price":7.08879534402769,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":54},
      {"date":"2025-05-25T00:00:00.000Z","views":3896,"purchases":1131,"average_price":7.08141198615577,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":54},
      {"date":"2025-05-18T00:00:00.000Z","views":4086,"purchases":1187,"average_price":7.07212879242805,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":54},
      {"date":"2025-05-11T00:00:00.000Z","views":4152,"purchases":1206,"average_price":7.08977004796596,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":54},
      {"date":"2025-05-04T00:00:00.000Z","views":4067,"purchases":1181,"average_price":7.10085489273385,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":53},
      {"date":"2025-04-27T00:00:00.000Z","views":4054,"purchases":1177,"average_price":7.09040335622257,"total_offers":41,"review_count":0,"review_rating":0,"best_seller_rank":53},
      {"date":"2025-04-20T00:00:00.000Z","views":4015,"purchases":1166,"average_price":7.08193281957489,"total_offers":43,"review_count":0,"review_rating":0,"best_seller_rank":53},
      {"date":"2025-04-13T00:00:00.000Z","views":3985,"purchases":1157,"average_price":7.07117264134342,"total_offers":44,"review_count":0,"review_rating":0,"best_seller_rank":53},
      {"date":"2025-04-06T00:00:00.000Z","views":4256,"purchases":1236,"average_price":7.05106770716462,"total_offers":47,"review_count":0,"review_rating":0,"best_seller_rank":54},
      {"date":"2025-03-30T00:00:00.000Z","views":4583,"purchases":1331,"average_price":7.03839819723086,"total_offers":45,"review_count":0,"review_rating":0,"best_seller_rank":57},
      {"date":"2025-03-23T00:00:00.000Z","views":4200,"purchases":1220,"average_price":7.02941078854904,"total_offers":47,"review_count":0,"review_rating":0,"best_seller_rank":61},
      {"date":"2025-03-16T00:00:00.000Z","views":3997,"purchases":1161,"average_price":7.01597988593666,"total_offers":52,"review_count":0,"review_rating":0,"best_seller_rank":66},
      {"date":"2025-03-09T00:00:00.000Z","views":4387,"purchases":1274,"average_price":7.00232762247367,"total_offers":53,"review_count":0,"review_rating":0,"best_seller_rank":68},
      {"date":"2025-03-02T00:00:00.000Z","views":4501,"purchases":1307,"average_price":6.98131025176806,"total_offers":54,"review_count":0,"review_rating":0,"best_seller_rank":69},
      {"date":"2025-02-23T00:00:00.000Z","views":4587,"purchases":1332,"average_price":6.95198315923983,"total_offers":54,"review_count":0,"review_rating":0,"best_seller_rank":75},
      {"date":"2025-02-16T00:00:00.000Z","views":4667,"purchases":1355,"average_price":6.92805262372083,"total_offers":52,"review_count":0,"review_rating":0,"best_seller_rank":79},
      {"date":"2025-02-09T00:00:00.000Z","views":5101,"purchases":1481,"average_price":6.95455416754194,"total_offers":53,"review_count":0,"review_rating":0,"best_seller_rank":85},
      {"date":"2025-02-02T00:00:00.000Z","views":4531,"purchases":1316,"average_price":6.98441596791898,"total_offers":50,"review_count":0,"review_rating":0,"best_seller_rank":93},
      {"date":"2025-01-26T00:00:00.000Z","views":4472,"purchases":1299,"average_price":6.95843822971513,"total_offers":50,"review_count":0,"review_rating":0,"best_seller_rank":98},
      {"date":"2025-01-19T00:00:00.000Z","views":4250,"purchases":1234,"average_price":6.92761661000337,"total_offers":49,"review_count":0,"review_rating":0,"best_seller_rank":100},
      {"date":"2025-01-12T00:00:00.000Z","views":3900,"purchases":1133,"average_price":6.9742623931362,"total_offers":51,"review_count":0,"review_rating":0,"best_seller_rank":107},
      {"date":"2025-01-05T00:00:00.000Z","views":3041,"purchases":883,"average_price":7.00965212104713,"total_offers":53,"review_count":0,"review_rating":0,"best_seller_rank":117}
    ]
  }
}

Sample response (SALES_ANALYSIS_HISTORY, .com, excerpt for B07C2Z21X5)

This excerpt combines the partial objects of an earlier sample into one result object. The product name is shortened and only two history weeks are shown.

{
  "result": {
    "product": {
      "asin": "B07C2Z21X5",
      "main_asin": "B07C2Z21X5-US",
      "marketplace": "US",
      "name": "Canon EOS Rebel T7 DSLR Camera with 18-55mm Lens...",
      "brand": "Canon",
      "category": "Camera & Photo/Digital Cameras/DSLR Cameras",
      "currency": "USD",
      "age": 6.7,
      "image_url": "41ZurL2c2rL.jpg",
      "launch_date": "2019-02-24T00:00:00.000Z",
      "is_exact_match": true,
      "product_type": "CAMERA_DIGITAL",
      "product_type_id": 686,
      "gl_product_group": 421,
      "gl_product_group_desc": "gl_camera",
      "physical": {
        "weight": "1.04",
        "weight_unit": "pounds",
        "height": "4.0",
        "length": "3.1",
        "dimension_unit": "inches"
      },
      "performance": {
        "traffic": {
          "total_views": 1232772,
          "views_last_30_days": 106497,
          "views_previous_30_days": 97873,
          "month_over_month_change": 0.08811418879568422,
          "quarter_over_quarter_change": -0.00492777124036603
        },
        "sales": {
          "purchases_last_30_days": 1054,
          "purchases_last_90_days": 3123,
          "purchases_last_360_days": 12206
        }
      },
      "pricing": {
        "average_price_last_90_days": 523.542275,
        "average_price_last_360_days": 488.450272,
        "offers": {
          "total_offers_last_90_days": 22,
          "new_offer_average_depth": 18.6836614202,
          "new_offer_max_price": 579.99,
          "new_offer_min_price": 7.99
        },
        "fees": {
          "fba_fee_last_360_days": 8.332521,
          "referral_fee_last_360_days": 37.15606
        }
      },
      "reviews_and_ranking": {
        "reviews": {
          "total_count": 8175,
          "average_rating": 4.7
        },
        "ranking": {
          "current_rank": 1,
          "category": "DSLR Cameras",
          "average_rank": 1
        }
      }
    },
    "history": [
      {
        "date": "2025-11-09T00:00:00.000Z",
        "views": 22277,
        "purchases": 220,
        "average_price": 466.96411048432157,
        "total_offers": 20,
        "review_count": 213,
        "review_rating": 4.8,
        "best_seller_rank": 1
      },
      {
        "date": "2025-11-02T00:00:00.000Z",
        "views": 8232,
        "purchases": 636,
        "average_price": 111.04167739439139,
        "total_offers": 3,
        "review_count": 124,
        "review_rating": 4.7,
        "best_seller_rank": 4
      }
    ]
  }
}

Notes

Check request_info.success and request_info.error_details on every response, even with HTTP 200. See the Real-Time API overview for errors and status codes.
The credits charged for the request are reported in request_info.credit_used_this_request, as on every other operation.
request_parameters.history_range echoes the value that was applied. It can come back as a number or a string.
Some samples omit fields, for example views_last_90_days or views_previous_90_days. Treat every field as optional in your parser.