# Search Insights Object

Source: https://env.7xmtools.com/api-docs/search-insights-object.html

Aggregated metrics calculated over *all* products that match a Product Finder query — ready-to-use KPIs such as average Buy Box prices, seller and brand distribution, fulfilment mix and review statistics.

JSON Object · Returned by: Product Finder (stats=1)

The Search Insights Object contains aggregated metrics calculated over *all* products that match a [Product Finder query](https://env.7xmtools.com/api-docs/product-finder.html) when the parameter `&stats=1` is supplied. It turns millions of individual products into immediate, ready-to-use key performance indicators (KPIs) such as average Buy Box prices, seller and brand distribution, fulfilment mix and review statistics.

> **Returned by:** the [Product Finder](https://env.7xmtools.com/api-docs/product-finder.html) request, as the field `searchInsights`, when called with `&stats=1`.

## Format

```json
{
  "avgDeltaPercent30BuyBox": Float,
  "avgDeltaPercent90BuyBox": Float,
  "avgDeltaPercent30Amazon": Float,
  "avgDeltaPercent90Amazon": Float,
  "avgBuyBox": Integer,
  "avgBuyBox90": Integer,
  "avgBuyBox365": Integer,
  "avgBuyBoxDeviation": Integer,
  "avgReviewCount": Integer,
  "avgRating": Integer,
  "isFBAPercent": Float,
  "soldByAmazonPercent": Float,
  "hasCouponPercent": Float,
  "avgOfferCountNew": Float,
  "avgOfferCountNewFBA": Float,
  "avgOfferCountNewFBM": Float,
  "avgOfferCountUsed": Float,
  "sellerCount": Integer,
  "brandCount": Integer,
  "highestRank": Integer,
  "lowestRank": Integer,
  "relatedCategories": Long[],
  "topBrandsWithCounts": { String: Integer, ... },
  "topSellersWithCounts": { String: Integer, ... }
}
```

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `avgDeltaPercent30BuyBox`<br>`avgDeltaPercent90BuyBox`<br>`avgDeltaPercent30Amazon`<br>`avgDeltaPercent90Amazon` | Float | Average percentage change in the Buy Box or Amazon price over the last 30 and 90 days, computed per product. Each product contributes equally, regardless of price. A positive value means the typical product became cheaper; negative means more expensive. Example: `-0.12` (= -0.12 %) |
| `avgBuyBox`<br>`avgBuyBox90`<br>`avgBuyBox365` | Integer | Average current, 90-day and 365-day Buy Box price across all selling products. Higher-priced products have more influence on this value. Example: `6711` (= € 67.11) |
| `avgBuyBoxDeviation` | Integer | Average deviation of the Buy Box price over the last 30 days for all selling products. Indicates short-term price volatility. In smallest currency unit. |
| `avgReviewCount` | Integer | Average number of reviews of all products in this category. |
| `avgRating` | Integer | Average rating of all products in this category. Example: `45` → 4.5 stars |
| `isFBAPercent` | Float | Share of products whose current Buy Box offer is Fulfilled by Amazon (FBA). Returned as a percentage value from `0.0` to `100.0`. Example: `78.3` (= 78.3 %) |
| `soldByAmazonPercent` | Float | Share of products currently *sold* by Amazon. |
| `hasCouponPercent` | Float | Share of products that have an active coupon. |
| `avgOfferCountNew` | Float | Average number of *new* offers per product (excludes out-of-stock). |
| `avgOfferCountNewFBA` | Float | Average number of *new* offers fulfilled by Amazon (FBA) per product, over the same products as `avgOfferCountNew`. A product without FBA offers counts as 0, so `avgOfferCountNewFBA` + `avgOfferCountNewFBM` comes close to `avgOfferCountNew`; the difference is products whose split is not known. |
| `avgOfferCountNewFBM` | Float | Average number of *new* offers fulfilled by the merchant (FBM) per product, counted the same way as `avgOfferCountNewFBA`. |
| `avgOfferCountUsed` | Float | Average number of *used* offers per product (excludes out-of-stock). |
| `sellerCount` | Integer | Total number of **distinct** sellers with at least one live offer in the result set. |
| `brandCount` | Integer | Total number of distinct brands represented. |
| `highestRank` | Integer | The *worst* (numerically highest) Sales Rank among all matched products. |
| `lowestRank` | Integer | The *best* (numerically lowest) Sales Rank among all matched products. |
| `relatedCategories` | Long\[\] | Up to five [category node ids](https://env.7xmtools.com/api-docs/category-object.html) of other categories in which the matched products are commonly co-listed, ordered by occurrence descending. Useful for cross-category navigation and recommendations. |
| `topBrandsWithCounts` | Map\<String, Integer> | Up to five most common brands and their product counts in the result set, ordered descending. Keys are brand names. |
| `topSellersWithCounts` | Map\<String, Integer> | Up to five seller IDs that hold the Buy Box most often within the result set, plus their occurrence counts, ordered descending. Keys are seller IDs. |

## Example

A Search Insights Object as returned in the `searchInsights` field of a [Product Finder](https://env.7xmtools.com/api-docs/product-finder.html) response with `&stats=1`:

```json
{
  "avgDeltaPercent30BuyBox": -0.12,
  "avgDeltaPercent90BuyBox": 1.85,
  "avgDeltaPercent30Amazon": -0.05,
  "avgDeltaPercent90Amazon": 0.92,
  "avgBuyBox": 6711,
  "avgBuyBox90": 6820,
  "avgBuyBox365": 7015,
  "avgBuyBoxDeviation": 312,
  "avgReviewCount": 1245,
  "avgRating": 45,
  "isFBAPercent": 78.3,
  "soldByAmazonPercent": 21.6,
  "hasCouponPercent": 9.4,
  "avgOfferCountNew": 5.2,
  "avgOfferCountNewFBA": 2.3,
  "avgOfferCountNewFBM": 2.8,
  "avgOfferCountUsed": 1.4,
  "sellerCount": 1830,
  "brandCount": 412,
  "highestRank": 1845020,
  "lowestRank": 3,
  "relatedCategories": [281052, 502394, 172282],
  "topBrandsWithCounts": {
    "sony": 210,
    "canon": 185,
    "panasonic": 120,
    "nikon": 95,
    "fujifilm": 74
  },
  "topSellersWithCounts": {
    "ATVPDKIKX0DER": 4210,
    "A2L77EE7U53NWQ": 830,
    "A3EXAMPLE0SELLER": 415,
    "A1EXAMPLE1SELLER": 260,
    "A9EXAMPLE2SELLER": 190
  }
}
```

*Illustrative values.*