Seller Object — Keepa API Documentation

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 request.

Note: The API does not provide information for sellers who only sell in the handmade category.

Format#

{
    "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 below.
`trackingSince`	Integer	The time when Keepa started tracking this seller, in Keepa Time minutes. Example: `2700145`
`lastUpdate`	Integer	The time of the last basic data update of this seller, in 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. 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 `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 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 request. Example: `["B00M0QVG3W", "B00M4KCH2A"]`
`asinListLastSeen`	Integer[]	Contains the last time (in 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 response:

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