# Sales Analysis and History: Response

> Response fields and sample JSON for the Easyparser SALES_ANALYSIS_HISTORY operation: product metrics, fees, offers, BSR and weekly history.

Source: https://docs.easyparser.com/real-time-integration/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](/real-time-integration/overview#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`](#resultproductphysical). |
| `performance` | object | Traffic and sales metrics. See [`result.product.performance`](#resultproductperformance). |
| `pricing` | object | Prices, offers and fees. See [`result.product.pricing`](#resultproductpricing). |
| `reviews_and_ranking` | object | Reviews and Best Sellers Rank. See [`result.product.reviews_and_ranking`](#resultproductreviews_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.

```json
{
  "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.

```json
{
  "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](/real-time-integration/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.