# Seller Object Source: https://env.7xmtools.com/api-docs/seller-object.html Information about an Amazon marketplace seller, including their name, rating history and rating count history. JSON Object · Returned by: Seller Information The Seller Object provides information about an Amazon marketplace seller, including their name, rating history, and rating count history. It is returned by the [Seller Information](https://env.7xmtools.com/api-docs/seller.html) request. > **Note:** The API does not provide information for sellers who only sell in the handmade category. ## Format ```json { "domainId": Integer, "trackingSince": Integer, "lastUpdate": Integer, "sellerId": String, "sellerName": String, "businessName": String, "address": String array, "tradeNumber": String, "vatID": String, "phoneNumber": String, "businessType": String, "shareCapital": String, "representative": String, "email": String, "customerServicesAddress": String array, "lastRatingUpdate": Integer, "ratingCount": Integer array, "positiveRating": Integer array, "negativeRating": Integer array, "neutralRating": Integer array, "recentFeedback": Feedback Object array, "hasFBA": Boolean, "totalStorefrontAsins": Integer array, "csv": Two-dimensional Integer array, "asinList": String array, "asinListLastSeen": Integer array, "sellerCategoryStatistics": Object array, "sellerBrandStatistics": Object array, "competitors": Object array, "avgBuyBoxCompetitors": Float, "buyBoxNewOwnershipRate": Integer, "buyBoxUsedOwnershipRate": Integer } ``` ## Fields ### Identification & basic data | Field | Type | Description | | --- | --- | --- | | `domainId` | Integer | The Amazon locale this seller belongs to. See the [valid domain IDs](https://env.7xmtools.com/api-docs/seller-object.html#domain-ids) below. | | `trackingSince` | Integer | The time when Keepa started tracking this seller, in [Keepa Time minutes](https://env.7xmtools.com/api-docs/seller-object.html#keepa-time-minutes). Example: `2700145` | | `lastUpdate` | Integer | The time of the last basic data update of this seller, in [Keepa Time minutes](https://env.7xmtools.com/api-docs/seller-object.html#keepa-time-minutes). This does not include ratings or storefront data. Example: `2711319` | | `sellerId` | String | The seller ID of the merchant. Example: `A2L77EE7U53NWQ` (Amazon.com Warehouse Deals) | | `sellerName` | String | The name of the seller. Example: `Amazon Warehouse Deals` | ### Business information Except for `businessName`, the following fields only appear in the response if there is a value. | Field | Type | Description | | --- | --- | --- | | `businessName` | String | The name of the business. Example: `Keepa GmbH` | | `address` | String\[\] | The business address. Each entry of the array contains one address line. The last entry contains the 2-letter country code. Example: `["123 Main Street", "New York, NY", "10001", "US"]` | | `tradeNumber` | String | The Trade Register Number. Example: `HRB 123 456` | | `vatID` | String | The VAT number. Example: `DE123456789` | | `phoneNumber` | String | The phone number. Example: `800 1234 567` | | `businessType` | String | The business type. Example: `Unternehmen in Privatbesitz` | | `shareCapital` | String | The share capital. Example: `25000` | | `representative` | String | The name of the business representative. Example: `Max Mustermann` | | `email` | String | The email address of the business. Example: `info@keepa.com` | | `customerServicesAddress` | String\[\] | The customer services address. Each entry of the array contains one address line. The last entry contains the 2-letter country code. Example: `["123 Main Street", "New York, NY", "10001", "US"]` | ### Ratings & feedback | Field | Type | Description | | --- | --- | --- | | `lastRatingUpdate` | Integer | The time of the last rating data update of this seller, in [Keepa Time minutes](https://env.7xmtools.com/api-docs/seller-object.html#keepa-time-minutes). Example: `2711319` | | `ratingCount` | Integer\[\] | Contains the rating counts for the last 30 days, 90 days, 365 days, and lifetime, in that order. Example: `[3, 10, 98, 321]` | | `positiveRating` | Integer\[\] | Contains the positive percentage ratings for the last 30 days, 90 days, 365 days, and lifetime, in that order. A positive rating is a 4 or 5-star rating. Example: `[96, 98, 98, 95]` | | `negativeRating` | Integer\[\] | Contains the negative percentage ratings for the last 30 days, 90 days, 365 days, and lifetime, in that order. A negative rating is a 1 or 2-star rating. Example: `[3, 1, 1, 3]` | | `neutralRating` | Integer\[\] | Contains the neutral percentage ratings for the last 30 days, 90 days, 365 days, and lifetime, in that order. A neutral rating is a 3-star rating. Example: `[1, 1, 1, 2]` | | `recentFeedback` | Feedback\[\] | Contains up to 5 of the most recent customer feedbacks. Only appears in the response if there is a value. Each feedback object contains:
• `date` Integer — timestamp of the feedback, in [Keepa Time minutes](https://env.7xmtools.com/api-docs/seller-object.html#keepa-time-minutes)
• `rating` Integer — the feedback star rating, value ranges from 10 (1 star) to 50 (5 stars)
• `isStriked` Boolean — indicates whether the feedback is striked | | `csv` | Integer\[\]\[\] | A two-dimensional history array containing historical data for this seller. First dimension index:
• **0** — `RATING`: the merchant's rating in percent, integer from 0 to 100
• **1** — `RATING_COUNT`: the merchant's total rating count, integer
The second dimension contains the history in the format `[Keepa Time minutes, value, ...]`. It is `null` if no data is available. Newly created merchant accounts may not yet have any ratings. | > **Tip:** To get the newest value, access the last entry of the array (after checking it is not `null`): most recent rating: `csv[0][csv[0].length - 1]`, most recent rating count: `csv[1][csv[1].length - 1]`. ### Storefront & statistics | Field | Type | Description | | --- | --- | --- | | `hasFBA` | Boolean | Indicates whether the seller currently has FBA (Fulfillment by Amazon) listings. This value is usually correct, but could be set to `false` even if the seller has FBA listings, since Keepa is not always aware of all seller listings. This can especially be the case with sellers with only a few listings consisting of slow-selling products. Example: `true` | | `totalStorefrontAsins` | Integer\[\] | Contains the number of storefront ASINs, based on Keepa's internal database aggregation (as of February 2026), if available, and the last update of that metric. `null` if not available (no storefront was ever retrieved). This field is available in the default [Seller Information](https://env.7xmtools.com/api-docs/seller.html) request (the `storefront` parameter is not required). Format: `[last update in Keepa Time minutes, count of storefront ASINs]`. Example: `[2711319, 1200]` | | `asinList` | String\[\] | An array containing up to 100,000 storefront ASINs, sorted by freshest first. The corresponding timestamps can be found in the `asinListLastSeen` field. Only available if the `storefront` parameter was used — see the [Seller Information](https://env.7xmtools.com/api-docs/seller.html) request. Example: `["B00M0QVG3W", "B00M4KCH2A"]` | | `asinListLastSeen` | Integer\[\] | Contains the last time (in [Keepa Time minutes](https://env.7xmtools.com/api-docs/seller-object.html#keepa-time-minutes)) Keepa was able to verify each ASIN in the `asinList` field. `asinList` and `asinListLastSeen` share the same indexation, so the corresponding timestamp for `asinList[10]` would be `asinListLastSeen[10]`. Example: `[2711319, 2711311]` | | `sellerCategoryStatistics` | Object\[\] | Statistics about the primary categories of this seller. Based on Keepa's often incomplete and outdated product offers data. Each object contains:
• `catId` Long — the category ID
• `productCount` Integer — the number of products this merchant sells in this category
• `avg30SalesRank` Integer — the 30-day average sales rank of these products
• `productCountWithAmazonOffer` Integer — how many of these products have an Amazon offer | | `sellerBrandStatistics` | Object\[\] | Statistics about the primary brands of this seller. Based on Keepa's often incomplete and outdated product offers data. Each object contains:
• `brand` String — the brand (in all lowercase)
• `productCount` Integer — the number of products this merchant sells with this brand
• `avg30SalesRank` Integer — the 30-day average sales rank of these products
• `productCountWithAmazonOffer` Integer — how many of these products have an Amazon offer | ### Competition & Buy Box | Field | Type | Description | | --- | --- | --- | | `competitors` | Object\[\] | The top five sellers most commonly offering the same products as this seller. Each object contains:
• `sellerId` String — the sellerId of the competitor
• `percent` Integer — the percentage of listings this competitor shares with the seller | | `avgBuyBoxCompetitors` | Float | Average number of sellers competing for the Buy Box of this seller's products (this seller included). | | `buyBoxNewOwnershipRate` | Integer | Average New Buy Box ownership percentage. | | `buyBoxUsedOwnershipRate` | Integer | Average Used Buy Box ownership percentage. | ### Valid domain IDs | Domain ID | Locale | | --- | --- | | **1** | com | | **2** | co.uk | | **3** | de | | **4** | fr | | **5** | co.jp | | **6** | ca | | **8** | it | | **9** | es | | **10** | in | | **11** | com.mx | | **12** | com.br | ## Keepa Time Minutes Time format used for all timestamps. To convert to an uncompressed Unix epoch time: - **For milliseconds:** `(keepaTime + 21564000) * 60000` - **For seconds:** `(keepaTime + 21564000) * 60` ## Example A Seller Object as returned inside the `sellers` map of a [Seller Information](https://env.7xmtools.com/api-docs/seller.html) response: ```json { "domainId": 1, "trackingSince": 2700145, "lastUpdate": 7662810, "sellerId": "A2L77EE7U53NWQ", "sellerName": "Amazon Warehouse Deals", "businessName": "Example Trading GmbH", "address": ["123 Main Street", "New York, NY", "10001", "US"], "vatID": "DE123456789", "lastRatingUpdate": 7662780, "ratingCount": [3, 10, 98, 321], "positiveRating": [96, 98, 98, 95], "negativeRating": [3, 1, 1, 3], "neutralRating": [1, 1, 1, 2], "recentFeedback": [ { "date": 7662500, "rating": 50, "isStriked": false }, { "date": 7661900, "rating": 10, "isStriked": true } ], "hasFBA": true, "totalStorefrontAsins": [7662810, 1200], "csv": [ [2711319, 95, 7000000, 96, 7662780, 96], [2711319, 280, 7000000, 305, 7662780, 321] ], "sellerCategoryStatistics": [ { "catId": 281052, "productCount": 214, "avg30SalesRank": 15230, "productCountWithAmazonOffer": 87 } ], "sellerBrandStatistics": [ { "brand": "sony", "productCount": 45, "avg30SalesRank": 9800, "productCountWithAmazonOffer": 21 } ], "competitors": [ { "sellerId": "A3EXAMPLE0SELLER", "percent": 34 } ], "avgBuyBoxCompetitors": 4.2, "buyBoxNewOwnershipRate": 62, "buyBoxUsedOwnershipRate": 18 } ``` *Response shortened for readability; illustrative values.* The `asinList` and `asinListLastSeen` fields (storefront requests only) are omitted here.