Get Keepa product

Request

Authorization

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

asin

required

The ASIN of the product you want to request.

Example:

B00U26V4VQ

domain

optional

Amazon marketplace domain. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. Options: amazon.com, amazon.ca, amazon.co.uk, amazon.de, amazon.es, amazon.it, amazon.fr, amazon.in, amazon.com.mx, amazon.com.br.

Example:

amazon.com

marketplaceId

optional

Amazon marketplace id. Domain amazon.com is used by default if domain and marketplaceId are not provided. If both domain and marketplaceId are chosen, domain has bigger priority. See all options here.

Example:

ATVPDKIKX0DER

stats

optional

Include a stats field with current prices and statistics. If specified, the product object will include a stats field with quick access to current prices, min/max prices, and weighted mean values. If the offers parameter is used, it will also provide Buy Box information.

You can provide the stats parameter in two forms:

Last x days (positive integer value): Calculates the stats for the last x days.

Interval: Specify a date range for the stats calculation using two timestamps (Unix epoch time in milliseconds) or two date strings (ISO8601 format, UTC).

Note: If there is insufficient historical data for a price type, the actual interval of the weighted mean calculation may be shorter than specified. All data provided via the stats field are calculated using the product object’s csv history field; no new data is provided through this parameter.

Examples:

&stats=180 (last 180 days)

&stats=2015-10-20,2015-12-24 (from Oct 20 to Dec 24, 2015)

&stats=2011-01-01,2025-01-01 (entire history)

&stats=1445299200000,1450915200000 (Unix epoch time in milliseconds, from Oct 20 to Dec 24, 2015)

Example:

update

optional

Force a refresh if the product’s last update is older than specified hours. Positive integer value. If the product’s last update is older than update hours, force a refresh. The default value used by the API is 1 hour. This parameter also works in conjunction with the offers parameter.

Using this parameter, you can achieve the following:

Speed up requests: If up-to-date data is not required, use a higher value than 1 hour.

Always retrieve live data: Use the value 0.

No update at all: Use the value -1.

Example:

history

optional

Exclude historical data fields to reduce response size and processing time. Boolean value (0 = false, 1 = true). If specified and set to 0, the product object will not include the csv, salesRanks, and salesRankReferenceHistory fields. If you do not need them, use this to have them removed from the response. This will improve processing time and considerably decrease the size of the response.

Example:

days

optional

Limit historical data to the recent X days. Any positive integer value. If specified with a positive value X, the product object will limit all historical data to the recent X days. This includes the csv, buyBoxSellerIdHistory, salesRankReferenceHistory, salesRanks, offers, and offers.offerCSV fields. If you do not need old historical data, use this to reduce the response size and improve processing time. The parameter does not use calendar days; so 1 day equals the last 24 hours.

Example:

offers

optional

Retrieve up-to-date marketplace offers. Positive integer value between 20 and 100. Determines the number of up-to-date marketplace offers to retrieve.

If the offers parameter is used, the product object will contain additional data:

Marketplace offer objects

Information on the New and Used Buy Box, including a history of Buy Box winners

Price history data for FBA (Fulfillment by Amazon), FBM (Fulfillment by Merchant), Warehouse Deals, Prime exclusive, and all Used and Collectible sub-conditions, including shipping and handling costs

Rating and review count history

All offers-related data is updated independently, irregularly, and not as often as all other product data. Keep this in mind when evaluating the additional historical data.

Notes:

The returned product may have more offers than specified because Keepa keep a history of offers. The number specified in this parameter determines how many offers Keepa attempt to retrieve/update from Amazon. Each offer object has a lastSeen field that can be used to filter up-to-date offers.

All offers-related data is freshly updated and up-to-date.

The request will require more time to complete, ranging from 2 to 20 seconds with an average of 5 seconds.

The request will return successfully and will contain, if available, all historical offers (unless only-live-offers is used) and product data. You can retry the request after a few minutes.

Limitations:

Not available for digital products, movie rentals, Amazon Fresh, and Amazon Pantry.

Example:

only-live-offers

optional

Include only live marketplace offers; reduces response size. Boolean value (0 = false, 1 = true). If specified and set to 1, the product object will only include live marketplace offers (when used in combination with the offers parameter). If you do not need historical offers, use this to reduce the response size and improve processing time.

Example:

rental

optional

Collect rental prices when available. Boolean value (0 = false, 1 = true). Can only be used in conjunction with the offers parameter. If specified and set to 1, the rental price will be collected when available.

Note:

Rental prices are only available for Amazon US and only for books (not for eBooks).

Example:

rating

optional

Include existing rating and review count history. Boolean value (0 = false, 1 = true). If specified and set to 1, the product object will include Keepa existing RATING and COUNT_REVIEWS history in the csv field, regardless of whether the offers parameter is used.

Using this parameter does not trigger an update to those two fields; it only gives access to Keepa existing data if available. If you need up-to-date data, you have to use the offers parameter. Use this if you need access to the rating data, which may be outdated, but do not need any other data fields provided through the offers parameter to speed up the request. If there is no rating data returned, you can still make another request using the offers parameter.

Example:

buybox

optional

Include Buy Box related data. Boolean value (0 = false, 1 = true). If specified and set to 1, the product and statistics object will include all available Buy Box related data:

Current price, price history, and statistical values

buyBoxSellerIdHistory

All Buy Box fields in the statistics object

The buybox parameter does not trigger a fresh data collection. If the offers parameter is used, the buybox parameter is ignored, as the offers parameter also provides access to all Buy Box related data. To access the statistics object, the stats parameter is required.

Example:

stock

optional

Include stock information in offers. Boolean value (0 = false, 1 = true). If specified together with the offers parameter and set to 1, the marketplace offer objects will include the stockCSV field, and the product object will include the lastStockUpdate field.

Note:

The stock parameter is not guaranteed to avoid triggering a fresh stock data collection. The request will require more time to retrieve stock data, ranging from 1 to 2 seconds per offer.

Example:

Responses

🟢200OK

application/json

Keepa product response

Body

productType

integer

optional

Must always be evaluated first. Determines what data for the product is available. Possible values:

0 - STANDARD: Everything accessible

1 - DOWNLOADABLE: No marketplace offers data

2 - EBOOK: No marketplace offers data

3 - INACCESSIBLE: No price, rating and offers data accessible. Sales rank and offer count data is updated less frequently. Some fields may be missing.

4 - INVALID: No current data available due to invalid or deprecated ASIN, or other issues. Might be temporary.

5 - VARIATION_PARENT: Product is a parent ASIN. variations is set.

Example:

asin

string

optional

The ASIN of the product.

Example:

B00U26V4VQ

domainId

integer

optional

The domainId of the product’s Amazon locale. Possible values: [ 1: com | 2: co.uk | 3: de | 4: fr | 5: co.jp | 6: ca | 8: it | 9: es | 10: in | 11: com.mx ]

Example:

title

string

optional

Title of the product. Caution: may contain unescaped HTML markup in rare cases.

Example:

CATAN Board Game - Embark on a Journey of Discovery and Trade! Civilization Building Strategy Game, Family Game for Kids & Adults, Ages 10+, 3-4 Players, 60-90 Minute Playtime, Made by CATAN Studio

trackingSince

integer

optional

States the time Keepa have started tracking this product, in Keepa Time minutes.

Example:

2240940

listedSince

integer

optional

States the time the item was first listed on Amazon, in Keepa Time minutes. This timestamp is only available for some products. If not available, the field has the value 0 or -1.

Example:

346862

lastUpdate

integer

optional

States the last time Keepa have updated the information for this product, in Keepa Time minutes.

Example:

7376140

lastRatingUpdate

integer

optional

States the last time Keepa have updated the product rating and review count, in Keepa Time minutes.

Example:

7376140

lastPriceChange

integer

optional

States the last time Keepa have registered a price change (any price type), in Keepa Time minutes.

Example:

7374028

lastEbayUpdate

integer

optional

States the last time Keepa have updated the eBay prices for this product, in Keepa Time minutes. If no matching products were found, the integer is negative.

Example:

7374894

lastStockUpdate

integer

optional

The most recent update of the stock data for this product’s offers, in Keepa Time minutes. This field is undefined unless the stock parameter was used and stock data was collected at least once.

Example:

7349428

imagesCSV

string

optional

CSV list of Amazon image names of the product. null if not available. Note that the variant images (all images after the primary/first one) are not necessarily in the same order as on Amazon.

Example:

81zZW70yiYL.jpg,81SkwdTQypL.jpg,916rkTg6h0L.jpg,81tqU4Hr-fL.jpg,91iOb49w2fL.jpg,81rSEZZBGzL.jpg,81cnasxCU0L.jpg,51Czq2ni9IL.jpg

rootCategory

integer

optional

Category node ID of the product’s root category. 0 if no root category known. The ID 9223372036854775807 (max signed long value) denotes a blank category with the name “?”. Keepa use this in cases where a product is listed in no or non-existent categories.

Example:

165793011

categories

array[integer]

optional

Array of Amazon category node IDs this product is listed in. Can be empty.

Example:

[166225011,19520348011,21394470011,19419995011,9765225011,24996084011,14052186011,119186712011,23717031011,24417464011,11308668011,23946859011,13443194011,19419985011]

categoryTree

array [object {2}]

optional

Represents the category tree as an ordered array of objects, each consisting of two fields: catId - Long - the category ID, name - String - the name of the category

Example:

[{"catId":165793011,"name":"Toys & Games"},{"catId":166220011,"name":"Games & Accessories"},{"catId":166225011,"name":"Board Games"}]

catId

integer

optional

name

string

optional

parentAsin

string

optional

The ASIN of the parent product (if the product has variations, otherwise null).

Example:

B00M0QVG3W

parentAsinHistory

array[string]

optional

The history of the parentAsin field. This array has the format: [keepaTime, previous parent ASIN, …]. The timestamp indicates when the previously associated parentAsin ceased to be valid. For the current parent ASIN, use the parentAsin field. undefined if the parentAsin field never changed. Keepa started tracking parentAsin changes on March 18th 2024.

Example:

["7367094","B0CTP7MWMF"]

variations

array [object {2}]

optional

Contains the variations of this product. Each object in the array represents a single variation. A variation object consists of the variation ASIN and an attributes array, where each entry represents one variation theme, including a dimension and its corresponding value. To request live data for this field, the offers parameter must be used.

Example:

[{"asin":"B07GFPNJL9","attributes":[{"dimension":"Size","value":"7.24 LB"},{"dimension":"FlavorName","value":"Cheddar"}]}]

asin

string

optional

attributes

array [object {2}]

optional

frequentlyBoughtTogether

array[string]

optional

One or two “Frequently Bought Together” ASINs. null if not available.

Example:

["B00U26V9CU","B00U26V4S4"]

upcList

array[string]

optional

A list of UPCs assigned to this product. The first index is the primary UPC. null if not available.

Example:

["029877030712"]

eanList

array[string]

optional

A list of EANs assigned to this product. The first index is the primary EAN. null if not available.

Example:

["0029877030712"]

manufacturer

string

optional

Name of the manufacturer. null if not available.

Example:

Asmodee

brand

string

optional

An item’s brand. null if not available.

Example:

Catan

productGroup

string

optional

The item’s productGroup. null if not available.

Example:

Toy

type

string

optional

The item’s productType. null if not available.

Example:

BOARD_GAME

partNumber

string

optional

The item’s partNumber. null if not available.

Example:

CN3071

binding

string

optional

The item’s binding. null if not available. If the item is not a book, it is usually the product category instead.

Example:

Board Game

numberOfItems

integer

optional

The number of items of this product. -1 if not available.

Example:

numberOfPages

integer

optional

The number of pages of this product. -1 if not available.

Example:

514

publicationDate

integer

optional

The item’s publication date in one of the following three formats: YYYY or YYYYMM or YYYYMMDD (Y = year, M = month, D = day). -1 if not available.

Example:

20150409

releaseDate

integer

optional

The item’s release date. Same format as publicationDate. -1 if not available.

Example:

20150423

contributors

array [array]

optional

The contributors of the item. A contributor can be an author, actor, director, etc. Each contributor entry has a name and a role type.

Example:

[["Vin Diesel","actor"]]

string

optional

languages

array [array]

optional

An item can have one or more languages. Each language entry has a name and most also have a type. null if not available.

Example:

[["English"],["English","Original Language"]]

string

optional

model

string

optional

The item’s model. null if not available.

Example:

CN3071

color

string

optional

The item’s color. null if not available.

Example:

Multicolor

size

string

optional

The item’s size. null if not available.

Example:

One Size

edition

string

optional

The item’s edition. null if not available.

Example:

Standard Edition

format

string

optional

The item’s format. null if not available.

Example:

AC-3

features

array[string]

optional

A list of up to 5 product features / bullet points. null if not available. An entry can contain HTML markup in rare cases. Keepa currently limit each entry to a maximum of 1000 characters (if the feature is longer it will be cut off). This limitation may change in the future without prior notice.

Example:

["EXPLORE CATAN: Set sail to the uncharted island of Catan and compete with other settlers to establish supremacy.","RESOURCE MANAGEMENT: Strategically gather and trade resources like ore, brick, lumber, grain, and wool to expand your settlements.","BUILD AND UPGRADE: Use your resources to build roads, settlements, and cities to earn victory points.","DYNAMIC GAMEPLAY: Roll the dice to collect resources based on terrain hexes, and employ clever tactics to outmaneuver your opponents.","CLASSIC GAME: Celebrate the 25th anniversary of CATAN, a timeless strategy board game loved by players worldwide."]

description

string

optional

A description of the product. null if not available. May contain HTML markup and newlines. Keepa limit the product description to a maximum of 4000 characters (if the description is longer it will be cut off). This limitation may change in the future without prior notice. To request live data for this field the offers parameter must be used.

Example:

Your adventurous settlers seek to tame the remote but rich isle of Catan. Start by revealing Catan's many harbors and regions: pastures, fields, mountains, hills, forests, and desert. The random mix creates a different board virtually every game. Guide your settlers to victory by clever trading and cunning development. Use resource combinations- grain, wool, ore, brick, and lumber-to buy handy development cards and build roads, settlements, and cities. Acquire your resources through trades,cards, or lucky dice (even outside your turn). But beware! Someone might cut off your road or buy a monopoly. And you never know when the wily robber might steal some of your precious gains! Catan((aka The Settlers of Catan) has been awarded with "Game of the Year," "Hall of Fame," and even "Game of the Century" honors in Germany, the United States, and a host of other countries worldwide. An international favorite, it's been called the "Perfect Social Game." Catan contains: 19 unique hexagonal terrain tile, 6 coastal frame pieces, 9 extra harbor pieces, 20 wooden settlements, 16 wooden cities, 60 wooden roads, 95 resource cards, 25 development cards, 4 building costs cards, 2 special bonus cards, 18 number tokens, 2 six-sided dice, 1 wooden robber pawn, simple rules & almanac.

hazardousMaterials

array [object {2}]

optional

The hazardous material types of the product. undefined if not available. Each entry consists of two fields: aspect - String, value - String.

aspect

string

optional

Example:

proper_shipping_name

value

string

optional

Example:

AEROSOLS

packageHeight

integer

optional

The package’s height in millimeters. 0 or -1 if not available.

Example:

packageLength

integer

optional

The package’s length in millimeters. 0 or -1 if not available.

Example:

296

packageWidth

integer

optional

The package’s width in millimeters. 0 or -1 if not available.

Example:

240

packageWeight

integer

optional

The package’s weight in grams. 0 or -1 if not available.

Example:

1222

packageQuantity

integer

optional

Quantity of items in the package. 0 or -1 if not available.

Example:

itemHeight

integer

optional

The item’s height in millimeters. 0 or -1 if not available.

Example:

itemLength

integer

optional

The item’s length in millimeters. 0 or -1 if not available.

Example:

300

itemWidth

integer

optional

The item’s width in millimeters. 0 or -1 if not available.

Example:

241

itemWeight

integer

optional

The item’s weight in grams. 0 or -1 if not available.

Example:

907

availabilityAmazon

integer

optional

Availability of the Amazon offer. Possible values:

-1: no Amazon offer exists,

0: Amazon offer is in stock and shippable,

1: Amazon offer is currently not in stock, but will be in the future (pre-order),

2: Amazon offer availability is “unknown”,

3: Amazon offer is currently not in stock, but will be in the future (back-order),

4: Amazon offer shipping is delayed - see “availabilityAmazonDelay” for more details.

Example:

availabilityAmazonDelay

array[integer]

optional

If availabilityAmazon has the value 4, this field will provide the delay interval in hours. null if no data is available.

Example:

[0,0]

buyBoxEligibleOfferCounts

array[integer]

optional

If buyBoxEligibleOfferCounts is available, it represents an array of integers, each entry indicating the total number of offers eligible for the Buy Box across specified offer conditions and fulfillment channels. This array contains eight elements, indexed as follows:

0: New FBA,

1: New FBM,

2: Used FBA,

3: Used FBM,

4: Collectible FBA,

5: Collectible FBM,

6: Refurbished FBA,

7: Refurbished FBM.

Example:

[3,2,0,0,0,0,0,0]

competitivePriceThreshold

integer

optional

The competitivePriceThreshold field is a price based on competitive prices from other retailers (excluding other Amazon sellers). The offer may be ineligible for the Buy Box if the seller’s price + shipping is greater than this competitive price. Undefined if it has no value.

Example:

2500

suggestedLowerPrice

integer

optional

The suggested lower price of the item, including shipping. The suggested lower price is based on a range of factors, including historical selling prices, recent Buy Box-eligible prices, and input from customers. Undefined if it has no value.

ebayListingIds

array[integer]

optional

Contains the lowest priced matching eBay listing Ids. Always contains two entries, the first one is the listing id of the lowest priced listing in new condition, the second in used condition. null or 0 if not available.

Example:

[710151859,325289877142]

isAdultProduct

boolean

optional

Indicates if the item is considered to be for adults only.

Example:

false

isHeatSensitive

boolean

optional

Indicates if the item is heat sensitive (e.g. meltable).

Example:

false

isMerchOnDemand

boolean

optional

True if this product is an Amazon Merch on Demand product. undefined otherwise.

Example:

true

isHaul

boolean

optional

True if this product is an Amazon Haul product. undefined otherwise. Only basic product information is available for Amazon Haul products.

Example:

true

ingredients

string

optional

The ingredient list of the product. undefined if not available.

Example:

Purified Carbonated Water, Natural Flavors

launchpad

boolean

optional

Indicates if the item is listed in the launchpad category. If so, the salesRankReference will not be available.

Example:

true

audienceRating

string

optional

Audience rating. The rating suggests the age for which the media is appropriate.

Example:

PG-13 (Parents Strongly Cautioned)

urlSlug

string

optional

The product listing URL slug.

Example:

CATAN-Board-Game-Discovery-Civilization

returnRate

integer

optional

This field provides information about the customer return rate for a product. The possible values are:

null: The return rate is either unavailable or considered average.

1: The product has a low return rate.

2: The product has a high return rate.

newPriceIsMAP

boolean

optional

Whether or not the lowest new price (either price type AMAZON or NEW) is restricted by MAP (Minimum Advertised Price). Use this to differentiate out of stock (price = -1) vs. MAP restriction.

Example:

true

isEligibleForTradeIn

boolean

optional

Whether or not the product is eligible for trade-in.

Example:

false

isEligibleForSuperSaverShipping

boolean

optional

Whether or not the product’s buy box is eligible for free shipping.

Example:

false

fbaFees

object

optional

pickAndPackFee

integer

optional

The FBA pick & pack fees of this product. The pickAndPackFee is determined by either the current price or, in the absence of a current offer, the previous one. If neither of these prices is available for reference, the fee percent is calculated based on a standard sales price of 100.00. Fees are integers of the respective Amazon locale’s smallest currency unit (e.g. euro cents or yen). null if not available.

Example:

661

variableClosingFee

integer

optional

The variable closing fee. Fees are integers of the respective Amazon locale’s smallest currency unit (e.g. euro cents or yen). Undefined if it has no value.

Example:

referralFeePercentage

integer

optional

The Amazon seller referral fee percent is determined by either the current price or, in the absence of a current offer, the previous one. If neither of these prices is available for reference, the fee percent is calculated based on a standard sales price of 100.00. null if not available.

Example:

coupon

array[integer]

optional

Contains coupon details for the buy box offer of the product, if available. null if not available. An integer array with two entries:

The first entry is the discount for a one-time coupon.

The second entry is a subscribe and save coupon.

Entry value is either 0 if no coupon of that type is offered, positive for an absolute discount, or negative for a percentage discount. The coupons field is always accessible, but only updated if the offers parameter was used in the Product Request.

Example:

[200,-15]

couponHistory

array[integer]

optional

Contains historical values for the coupon field, if available. null if not available. Keepa started tracking coupon history on June 15th 2024. Format: [ keepaTime, one-time coupon, subscribe and save coupon, keepaTime, … ]

Example:

[7339566,461,0,7340010,0,0,7356384,625,0]

promotions

array [object {3}]

optional

Contains an array of active promotions. Not all product promotions can be provided. A promotion object consists of: type - String - The type of promotion, amount - Integer - The discounted price, discountPercent - Integer - The discount percent.

type

string

optional

The type of promotion

Example:

SNS

amount

integer

optional

The discounted price

Example:

100

discountPercent

integer

optional

The discount percent

Example:

unitCount

object

optional

Object that contains unit count data, Undefined if it has no value.

unitValue

number <double>

optional

The field returns the specified weight or volume to facilitate per unit pricing. For products measured by volume, weight, or linear dimensions, it provides the total net quantity shipped for a single ASIN (e.g., a 12-pack of 6 fl oz bottles of water = 72 fl oz, or a single 2-liter bottle = 2 liters). For products sold as individual units, it returns the total number of units (e.g., a pack of 12 pens = 12).

Example:

unitType

string

optional

In cases where the product being sold is measured in units that are relevant to the customer’s purchasing decision, the unitType specifies the type of measurement used. For example, a bottle of soda may be measured in fluid ounces, while a box of screws is measured by the number of screws in the box.

Example:

Count

eachUnitCount

number <double>

optional

The number of units in an ‘each’; where an ‘each’ refers to the smallest component of a product with a UPC, and a unit defines how this ‘each’ is measured.

salesRankReference

integer

optional

The category node id of the main sales rank. -1 if not available, -2 if listed in launchpad.

Example:

165793011

salesRankReferenceHistory

array[integer]

optional

A long array containing the historical category node id(s) of the main sales rank. This data, if available, can be used to match historical sales ranks provided in the CSV field to their reference category. The category id has the value -1 if not available or -2 if listed in launchpad. Format: [ keepaTime, category node id, … ]

Example:

[7333764,165793011]

salesRanks

object

optional

An object containing sales rank histories. Each key represents the categoryId of the rank, with the history in the corresponding value.

Example:

{"165793011":[7371626,29,7372008,30,7372414,31,7372518,35],"166225011":[7369930,1,7375618,3,7375864,2,7376008,3,7376106,2]}

Additional properties

array[integer]

optional

lastSoldUpdate

integer

optional

States the last time Keepa have updated the monthlySold field, in Keepa Time minutes. Undefined if the monthlySold has no value.

Example:

7376384

monthlySold

integer

optional

How often this product was bought in the past month. This field represents the bought past month metric found on Amazon search result pages. It is not an estimate. Amazon only provides the data in bracketed ranges such as “50+” or “100+”, rather than as exact figures. Undefined if it has no value. Most ASINs do not have this value set. The value is variation specific.

Example:

20000

monthlySoldHistory

array[integer]

optional

Contains historical values of the monthlySold field. Undefined if it has no value. Format: [ keepaTime, monthlySold, … ]

Example:

[7375948,20000,7375956,30000,7376044,20000,7376052,30000,7376136,20000]

rentalDetails

string

optional

Contains the rental details description of the rental buy box offer. null if not available. Accessible only if the offers and rental parameters were used in the Product Request.

Example:

Rented from: RentU Rental Price One Semester: $25.24 Extension Prices 15 Day: $12.61 Additional Semester: $25.24 Buyout Price: $34.89. Any rental and extension fees paid will be applied towards the buyout price of the book.

rentalSellerId

string

optional

Contains the seller id of the rental buy box offer. null if not available. Accessible only if the offers and rental parameters were used in the Product Request.

Example:

A2L77EE7U53NWQ

rentalPrices

object

optional

This object contains the rental prices (as described in the rentalDetails field) initialPrice, shortExtnPrice, longExtnPrice, and fullPrice. null if not available. Accessible only if the offers and rental parameters were used in the Product Request.

Example:

null

Additional properties

integer

optional

reviews

object

optional

This object contains variation specific review and rating counts histories as well as a last update timestamp. null if not available. It is not possible to force an update to the reviews object data. For non-variation specific ratings and review data access the csv field. Accessible only if the rating parameter was used in the Product Request.

lastUpdate

integer

optional

The last update timestamp in Keepa Time minutes.

Example:

7365044

ratingCount

array[integer]

optional

Variation specific rating counts history. Format: [ keepaTime, ratingCount, … ]

Example:

[7353286,34550,7363060,34590,7365044,34608]

reviewCount

array[integer]

optional

Variation specific review counts history. Format: [ keepaTime, reviewCount, … ]

Example:

[7335552,5383,7339328,5385,7349412,5393,7353286,5396,7363060,5408,7365044,5411]

liveOffersOrder

array[integer]

optional

Optional field, set only if the offers parameter was used in the Product Request. Contains an ordered array of index positions in the offers array for all Marketplace Offer Objects retrieved for this call. If no offers were found, the field will be null. The sequence of integers reflects the ordering of the offers on the Amazon offer page (for all conditions). Since the offers field contains historical offers as well as current offers, one can use this array to look up all offers that are currently listed on Amazon in the correct order. Note: If there are identical offers (same seller, same condition, same shipping type, and same condition text) Keepa only track the lowest-priced one. If this happens, there will be duplicate offer indexes in the liveOffersOrder field at the position of the omitted duplicate (higher-priced) offer - all pointing to the lowest-priced offer’s index.

Example: [ 3, 5, 2, 18, 15 ] - The offer with the array index 3 of the offers field is currently the first one listed on the offer listings page on Amazon, followed by the offer with the index 5, and so on.

Example with duplicates: [ 3, 5, 2, 18, 5 ] - The second offer, as listed on Amazon, is a lower-priced duplicate of the 5th offer on Amazon. The lower-priced one is included in the offers field at index 5.

Example:

[0,1,2,3,4,5,6]

buyBoxSellerIdHistory

array[string]

optional

Optional field, set only if the offers or buybox parameter was used in the Product Request. Contains a history of sellerIds that held the Buy Box in the format: Keepa time minutes, sellerId, […]. If no seller qualified for the Buy Box, the sellerId “-1” is used (suppressed Buy Box). If Keepa were unable to identify the seller or if the product was out of stock (no seller), the sellerId is “-2”.

Example:

["7339514","ATVPDKIKX0DER"]

buyBoxUsedHistory

array[string]

optional

Optional field, set only if the offers or buybox parameter was used in the Product Request. A history of used buy box winners, containing the sellerIds, offer sub-condition, and FBA status in the format: Keepa time minutes, seller id, condition, isFBA, […]. If no seller qualified for the used buy box, the sellerId “” (empty String) is used.

Condition can have the following values:

“2” - Used - Like New, “3” - Used - Very Good, “4” - Used - Good, “5” - Used - Acceptable

isFBA is either “1” - offer is FBA or “0” - offer is merchant fulfilled.

Example:

["2860926","ATVPDKIKX0DER","4","1"]

isRedirectASIN

boolean

optional

Valid only if the offers parameter was used in the Product Request. Boolean indicating if the ASIN will be redirected to another one on Amazon (example: the ASIN has the color black variation, which is not available and is redirected on Amazon to the color red).

Example:

false

isSNS

boolean

optional

Valid only if the offers parameter was used in the Product Request. Boolean indicating if the product’s Buy Box is available for subscribe and save.

Example:

false

offersSuccessful

boolean

optional

Valid only if the offers parameter was used in the Product Request. Boolean indicating if the system was able to retrieve fresh offer information. Retrieval of fresh offers will always fail if the product has no offers (compare COUNT_* csv entries).

Example:

true

offers

array[object (KeepaProductOffer) {21}]

optional

Optional field, set only if the offers parameter was used. Contains Marketplace Offer Objects.

offerId

integer

optional

Unique ID of this offer (in the scope of the product). Not related to the offerIds used by Amazon, as those are user-specific and valid only for a short time. The offerId can be used to identify the same offers throughout requests.

Example:

553

lastSeen

integer

optional

Indicates the last time Keepa have seen (and updated) this offer, in Keepa Time minutes. If you are only interested in live offers, use this field to verify that the offer is current.

Example:

7376384

sellerId

string

optional

The seller ID of the merchant.

Example:

A2FP3WC79CXYXU

isPrime

boolean

optional

Whether or not this offer is available via Prime shipping. Keepa is unable to reliably identify SFP - Seller Fulfilled Prime.

Example:

true

isFBA

boolean

optional

Whether or not this offer is fulfilled by Amazon.

Example:

true

isMAP

boolean

optional

If the price of this offer is hidden on Amazon due to a MAP (“minimum advertised price”) restriction. Even if so, the offer object will contain the price and shipping costs.

Example:

false

isShippable

boolean

optional

Boolean value indicating whether or not the offer is currently shippable. If not, this could mean, for example, that it is temporarily out of stock or a pre-order.

Example:

true

isAddonItem

boolean

optional

Indicating whether or not the offer is an Add-on item.

Example:

false

isPreorder

boolean

optional

Indicating whether or not the offer is a pre-order.

Example:

false

isWarehouseDeal

boolean

optional

Indicating whether or not the offer is a Warehouse Deal.

Example:

false

isScam

boolean

optional

Boolean value indicating whether or not Keepa system identified that the offering merchant attempts to scam users.

Example:

false

shipsFromChina

boolean

optional

Boolean value indicating whether or not this offer’s seller default shipping location is China. This does not apply to FBA offers.

Example:

false

isAmazon

boolean

optional

True if the seller is Amazon (e.g. “Amazon.com”). Note: Amazon’s Warehouse Deals seller account or other accounts Amazon is maintaining under a different name are not considered to be Amazon.

Example:

false

isPrimeExcl

boolean

optional

This offer has a discounted Prime exclusive price.

Example:

false

coupon

integer

optional

Contains one-time coupon details of this offer. Undefined if none is available. Positive integer for an absolute discount or negative for a percentage discount.

500 - Coupon with a $5 discount.

-15 - Coupon with a 15% discount.

Example:

500

couponHistory

array[integer]

optional

Contains the coupon history of this offer, if available. It has the format Keepa time minutes, coupon, […].

Example:

[6872588,0]

condition

integer

optional

The condition of the offered product. Integer value:

0 - Unknown,

1 - New,

2 - Used - Like New,

3 - Used - Very Good,

4 - Used - Good,

5 - Used - Acceptable,

6 - Refurbished,

7 - Collectible - Like New,

8 - Collectible - Very Good,

9 - Collectible - Good,

10 - Collectible - Acceptable,

11 - Rental.

Note: Open Box conditions are coded as Used conditions.

Example:

conditionComment

string

optional

The describing text of the condition.

Example:

The item may come repackaged. Small cosmetic imperfection on top, […]

offerCSV

array[integer]

optional

Contains the current price and shipping costs of the offer as well as, if available, the offer’s history. It has the format Keepa time minutes, price, shipping cost, […].

The price and shipping cost are integers of the respective Amazon locale’s smallest currency unit (e.g. euro cents or yen).

If Keepa were unable to determine the price or shipping cost, they have the value -2.

Free shipping has the shipping cost of 0.

If an offer is not shippable or has unspecified shipping costs, the shipping cost will be -1.

To get the newest price and shipping cost, access the last two entries of the array.

Most recent price: offerCSV[offerCSV.length - 2]

Most recent shipping cost: offerCSV[offerCSV.length - 1]

Example:

[7371726,4999,0,7376384,3367,0]

stockCSV

array[integer]

optional

The stock history for this offer, provided the stock product request parameter was utilized. This data represents Keepa best attempt to determine the available stock quantity for this offer, though it may not always be accurate, such as in instances where per-customer limits apply. Stock data availability is not guaranteed. undefined if unavailable. It has the format Keepa time minutes, stock, […].

Example:

[7371494,1,7376140,2]

primeExclCSV

array[integer]

optional

Contains the Prime exclusive price history of this offer, if available. A Prime exclusive offer can only be ordered if the buyer has an active Prime subscription. It has the format Keepa time minutes, price, […].

stats

object (KeepaProductStats)

optional

Contains a Statistics Object.

current

array[integer]

optional

Contains the last updated product prices/ranks using the Price Type indexing (refer to the csv field in the KeepaProduct). Prices are integers representing the smallest currency unit for the respective Amazon locale (e.g., euro cents or yen). A value of -1 indicates no offer was available in the given interval (e.g., out of stock).

Example:

[2500,2500,-1,56,5499,-1,-1,4647,-1,-1,3367,7,-1,-1,-1,7,48,37323,2500,-1,-1,-1,-1,-1,-1,-1,-1,-1,1599,219,-1,-1,-1,-1]

avg

array[integer]

optional

Contains the historical weighted mean for the interval specified in the product request’s stats parameter using the Price Type indexing. A value of -1 indicates no offer was available in the interval or insufficient data.

Example:

[2512,2582,-1,139,5499,-1,-1,4742,-1,-1,3755,5,-1,-1,-1,-1,48,45366,2512,-1,-1,-1,-1,-1,-1,-1,-1,-1,1767,808,-1,-1,-1,-1]

avg30

array[integer]

optional

Same as avg, but for the last 30 days.

Example:

[2512,2582,-1,139,5499,-1,-1,4742,-1,-1,3755,5,-1,-1,-1,-1,48,45366,2512,-1,-1,-1,-1,-1,-1,-1,-1,-1,1767,808,-1,-1,-1,-1]

avg90

array[integer]

optional

Same as avg, but for the last 90 days.

Example:

[3425,3378,3127,241,5601,4298,-1,4859,-1,3102,4434,5,1,-1,0,-1,48,45694,3427,3286,3176,-1,2639,-1,4298,-1,-1,-1,1767,1284,-1,-1,3279,-1]

avg180

array[integer]

optional

Same as avg, but for the last 180 days.

Example:

[3858,3769,3223,221,5800,4130,-1,5124,-1,3212,4638,7,1,-1,0,-1,48,45067,3858,3293,3184,3074,2639,-1,4162,2998,-1,-1,5078,1300,-1,-1,3276,3374]

avg365

array[integer]

optional

Same as avg, but for the last 365 days.

Example:

[4075,3991,3194,211,5813,3929,-1,5061,-1,3185,4584,9,1,-1,1,-1,48,43833,4074,3271,3132,3074,2639,-1,4248,3579,2857,-1,5899,1300,-1,-1,3269,3374]

atIntervalStart

array[integer]

optional

Contains prices registered at the start of the interval specified in the product request’s stats parameter using the Price Type indexing. A value of -1 indicates no offer was available in the interval or insufficient data.

Example:

[2549,2549,-1,96,5499,-1,-1,4999,-1,-1,4659,4,-1,-1,-1,4,48,47631,2549,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,1701,-1,-1,-1,-1]

min

array [array]

optional

Contain the lowest prices ever registered for this product. The first dimension uses the Price Type indexing. The second dimension is either null (no data available for the price type) or an array of size 2 with the first value being the time of the extreme point (in Keepa Time minutes) and the second value being the respective extreme value.

Example:

[[4709928,2100],[3259414,1],[5754116,1825],[5182524,2],[3651144,3750],[3449544,799],null,[3189672,1],[3523616,2449],[5735496,1650],[6738682,2099],[3543146,1],[2338720,1],[6539248,0],[2412158,1],null,[4647484,42],[4647484,16],[6738680,2099],[4710276,1995],[4710112,1932],[4712932,1969],[5799036,1702],[3506622,1665],[4837310,1799],[3464492,2495],[3526988,2399],null,[3226628,460],[7350370,219],null,null,[6267992,2400],[6718184,2564]]

max

array [array]

optional

Contain the highest prices ever registered for this product.The first dimension uses the Price Type indexing. The second dimension is either null (no data available for the price type) or an array of size 2 with the first value being the time of the extreme point (in Keepa Time minutes) and the second value being the respective extreme value.

Example:

[[5633256,5299],[3654504,9999],[3778320,4476],[2241840,66517],[6609220,5999],[2627856,11600],null,[6247744,10489],[6193860,3349],[3779252,4476],[4872696,8997],[3088008,120],[4846466,8],[6539248,0],[5459938,26],null,[3464606,50],[6882580,48772],[6472404,7047],[4249052,4322],[3779252,4476],[4249424,3881],[4250884,3308],[4870390,8573],[3412840,11699],[6004564,5500],[6299472,5465],null,[5230790,7439],[3920522,13000],null,null,[6604464,3907],[6323572,4632]]

minInInterval

array [array]

optional

Same as min, but restricted to the interval specified in the product request’s stats parameter.

Example:

[[7336466,2500],[7336466,2500],[-1,-1],[7357514,2],[7333196,5499],[-1,-1],null,[7333900,4024],[-1,-1],[-1,-1],[7341912,3318],[7333460,1],[-1,-1],[-1,-1],[-1,-1],null,[7333196,48],[7366960,34630],[7336466,2500],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],null,[7365430,1599],[7350370,219],null,null,[-1,-1],[-1,-1]]

maxInInterval

array [array]

optional

Same as max, but restricted to the interval specified in the product request’s stats parameter.

Example:

[[7333288,2679],[7333528,6412],[-1,-1],[7340398,516],[7333196,5499],[-1,-1],null,[7344566,5499],[-1,-1],[-1,-1],[7333528,6412],[7347928,9],[-1,-1],[-1,-1],[-1,-1],null,[7333196,48],[7366424,47813],[7333288,2679],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],[-1,-1],null,[7335054,1999],[7333196,1701],null,null,[-1,-1],[-1,-1]]

outOfStockPercentageInInterval

array[integer]

optional

Contains the out-of-stock percentage in the interval specified in the product request’s stats parameter using the Price Type indexing. A value of -1 indicates insufficient data or the Price Type is not a price.

Examples:

0: Never out of stock,

100: Out of stock 100% of the time,

25: Out of stock 25% of the time.

Example:

[3,1,100,-1,1,100,-1,6,100,100,10,-1,-1,-1,-1,-1,-1,-1,3,100,100,100,100,100,100,100,100,-1,25,0,-1,-1,100,100]

outOfStockPercentage30

array[integer]

optional

Contains the 30-day out-of-stock percentage using the Price Type indexing. A value of -1 indicates insufficient data or the Price Type is not a price.

Example:

[3,1,100,-1,1,100,-1,6,100,100,10,-1,-1,-1,-1,-1,-1,-1,3,100,100,100,100,100,100,100,100,-1,25,0,-1,-1,100,100]

outOfStockPercentage90

array[integer]

optional

Same as outOfStockPercentage30, but for the last 90 days.

Example:

[2,1,92,-1,1,84,-1,3,100,93,41,-1,-1,-1,-1,-1,-1,-1,3,96,97,100,99,100,84,100,100,-1,75,3,-1,-1,97,100]

outOfStockPercentage180

array[integer]

optional

Same as outOfStockPercentage30, but for the last 180 days.

Example:

[1,1,87,-1,1,90,-1,2,100,89,21,-1,-1,-1,-1,-1,-1,-1,2,91,97,100,100,100,91,100,100,-1,61,44,-1,-1,93,98]

outOfStockPercentage365

array[integer]

optional

Same as outOfStockPercentage30, but for the last 365 days.

Example:

[1,1,82,-1,1,87,-1,2,100,84,11,-1,-1,-1,-1,-1,-1,-1,1,88,95,100,99,100,88,100,100,-1,59,73,-1,-1,89,99]

salesRankDrops30

integer

optional

The count of sales rank drops (from high to low value) within the last 30 days, considered to indicate sales.

Example:

115

salesRankDrops90

integer

optional

Same as salesRankDrops30, but for the last 90 days.

Example:

427

salesRankDrops180

integer

optional

Same as salesRankDrops30, but for the last 180 days.

Example:

935

lastOffersUpdate

integer

optional

The last time the offers information was updated (in Keepa Time minutes).

Example:

7376384

totalOfferCount

integer

optional

The total count of offers for this product (all conditions combined). The offer count per condition can be found in the current field.

Example:

lightningDealInfo

array[integer]

optional

Used to identify a past, upcoming, or current lightning deal offer. The format is [startDate, endDate] (always an array of length 2 if not null). It is null if the product never had a lightning deal. Both timestamps are in UTC and Keepa Time minutes. If there is an upcoming lightning deal, only startDate is set (with endDate having a value of -1). If there is a current lightning deal, both startDate and endDate will be set, with startDate older than the current time and endDate in the future. If there is only a past deal, both startDate and endDate will be set in the past.

Example:

[6586980,6589860]

lastBuyBoxUpdate

integer

optional

Timestamp of the last buy box update, in KeepaTime.

Example:

7376384

buyBoxSellerId

string

optional

The seller ID of the buy box offer, if it exists. Otherwise, "-1", "-2", or null.

Example:

ATVPDKIKX0DER

buyBoxPrice

integer

optional

The buy box new price, if it exists. Otherwise, -1 or -2.

Example:

2500

buyBoxShipping

integer

optional

The buy box new shipping cost, if it exists. Otherwise, -1 or -2.

Example:

buyBoxIsUnqualified

boolean

optional

Indicates whether a seller won the buy box. If only sellers with poor offers are available, none qualifies for the buy box.

Example:

false

buyBoxIsShippable

boolean

optional

Indicates whether the buy box is listed as being shippable.

Example:

true

buyBoxIsPreorder

boolean

optional

Indicates if the buy box is a pre-order.

Example:

false

buyBoxIsBackorder

boolean

optional

Indicates if the buy box is back-ordered.

Example:

false

buyBoxIsFBA

boolean

optional

Indicates whether the buy box is fulfilled by Amazon.

buyBoxIsAmazon

boolean

optional

Indicates if Amazon is the seller in the buy box.

buyBoxIsMAP

boolean

optional

Indicates if the buy box new price is hidden on Amazon due to MAP (Minimum Advertised Price) restrictions.

buyBoxMinOrderQuantity

integer

optional

The minimum order quantity of the buy box. -1 if not available, 0 if no limit exists.

Example:

buyBoxMaxOrderQuantity

integer

optional

The maximum order quantity of the buy box. -1 if not available, 0 if no limit exists.

Example:

buyBoxAvailabilityMessage

string

optional

The availability message of the buy box. null if not available

Example:

In Stock.

buyBoxShippingCountry

string

optional

The default shipping country of the buy box seller. null if not available or if the seller is Amazon

Example:

buyBoxIsPrimeExclusive

boolean

optional

Indicates if the buy box is Prime exclusive. null if not available.

buyBoxIsPrimeEligible

boolean

optional

Indicates if the buy box is Prime eligible. null if not available.

buyBoxIsPrimePantry

boolean

optional

Indicates if the buy box is a Prime Pantry offer. null if not available.

buyBoxStats

object

optional

Contains buy box statistics for the specified interval. Each key represents the sellerId of the buy box seller, and each value is an object with statistics.

Example:

{"ATVPDKIKX0DER":{"percentageWon":97.09722,"avgPrice":2512,"avgNewOfferCount":1,"avgUsedOfferCount":-1,"isFBA":true,"lastSeen":7376396}}

buyBoxUsedStats

object

optional

Contains used buy box statistics for the specified interval. The format is the same as buyBoxStats.

buyBoxUsedPrice

integer

optional

The buy box used price, if available. Otherwise, -1 or null.

buyBoxUsedShipping

integer

optional

The buy box used shipping cost, if available. Otherwise, -1 or null.

buyBoxUsedSellerId

string

optional

The seller ID of the used buy box offer, if available. Otherwise, null.

Example:

A2FP3WC79CXYXU

buyBoxUsedIsFBA

boolean

optional

Indicates whether the used buy box is fulfilled by Amazon.

buyBoxUsedCondition

integer

optional

The offer sub-condition of the used buy box.

Value:

2 - Used - Like New,

3 - Used - Very Good,

4 - Used - Good,

5 - Used - Acceptable.

retrievedOfferCount

integer

optional

The count of retrieved offers for this request.

Example:

-2

isAddonItem

boolean

optional

Indicates whether the product is an add-on item (ships with orders that include $25 or more of items shipped by Amazon).

Example:

false

sellerIdsLowestFBA

array[string]

optional

Contains the seller IDs (if any) of the lowest-priced live new FBA offers. Multiple entries exist if multiple offers share the same price.

Example:

["A2FP3WC79CXYXU"]

sellerIdsLowestFBM

array[string]

optional

Contains the seller IDs (if any) of the lowest-priced live new FBM offers. Multiple entries exist if multiple offers share the same price.

Example:

["A1TSKR6QH55IJL"]

offerCountFBA

integer

optional

The count of retrieved live new FBA offers, if available. Otherwise, -2.

Example:

offerCountFBM

integer

optional

The count of retrieved live new FBM offers, if available. Otherwise, -2.

Example:

stockAmazon

integer

optional

The stock of the Amazon offer, if available. Otherwise, undefined.

stockBuyBox

integer

optional

The stock of the buy box offer, if available. Otherwise, undefined.

csv

array [array]

optional

A two-dimensional history array containing the product’s historical data. Access the first dimension index using the following enum/constants:

0 - AMAZON,

1 - NEW,

2 - USED,

3 - SALES,

4 - LISTPRICE,

5 - COLLECTIBLE,

6 - REFURBISHED,

7 - NEW_FBM_SHIPPING,

8 - LIGHTNING_DEAL,

9 - WAREHOUSE,

10 - NEW_FBA,

11 - COUNT_NEW,

12 - COUNT_USED,

13 - COUNT_REFURBISHED,

14 - COUNT_COLLECTIBLE,

15 - EXTRA_INFO_UPDATES,

16 - RATING,

17 - COUNT_REVIEWS,

18 - BUY_BOX_SHIPPING,

19 - USED_NEW_SHIPPING,

20 - USED_VERY_GOOD_SHIPPING,

21 - USED_GOOD_SHIPPING,

22 - USED_ACCEPTABLE_SHIPPING,

23 - COLLECTIBLE_NEW_SHIPPING,

24 - COLLECTIBLE_VERY_GOOD_SHIPPING,

25 - COLLECTIBLE_GOOD_SHIPPING,

26 - COLLECTIBLE_ACCEPTABLE_SHIPPING,

27 - REFURBISHED_SHIPPING,

28 - EBAY_NEW_SHIPPING,

29 - EBAY_USED_SHIPPING,

30 - TRADE_IN,

31 - RENTAL,

32 - BUY_BOX_USED_SHIPPING,

33 - PRIME_EXCL.

The second dimension contains the price/value history in the format Keepa time minutes, value, […] or, if the type includes *_SHIPPING costs, the format: Keepa time minutes, price, shipping costs, […]. If history is unavailable, it is null. The price is an integer of the respective Amazon locale’s smallest currency unit (e.g., euro cents or yen). If no offer was available in the given interval (e.g., out of stock), the price has the value -1.

Important csv information:

Keepa only append a new entry to the history array if the price/value changed, not every time Keepa update the product.

Shipping and Handling costs are not included unless specified.

Amazon is considered to be part of the marketplace. If Amazon has the overall lowest new price, the marketplace new price in the corresponding time interval is identical to the Amazon price.

The following types are only set if the offers parameter was used in the Product Request: NEW_FBM_SHIPPING, WAREHOUSE, NEW_FBA, RATING, COUNT_REVIEWS, BUY_BOX_SHIPPING, USED_SHIPPING, COLLECTIBLE_SHIPPING, REFURBISHED_SHIPPING, BUY_BOX_USED_SHIPPING, and PRIME_EXCL

About Lightning deals: If a deal is currently active, the last entry of the history array will contain the end date (a future date) with a price of -1. When accessing the current deal price, handle this special case. Alternatively, use the current price array of the stats object to access the current price. If no deal is currently active but the last entry has the value -1 with a date in the future, it means an upcoming deal is announced (scheduled to start at that date).

About eBay prices: eBay listings often have incorrect information and/or product codes, causing item mismatches and incorrect pricing information. Use eBay price history information with caution and do not rely on their accuracy. Keepa update eBay prices at different intervals than Amazon prices.

Keepa can add new data types to the csv field from time to time without announcement. Do not expect a fixed size of the first array dimension in your implementation.

Example:

[[7345328,2500],[7345328,2500],[7303544,-1],[7371626,29,7372008,30,7372414,31,7372518,35],[7339416,5499],[7286744,-1],null,[7362962,4647,0],[6589860,-1],[7303544,-1],[7371726,4936,7374028,4931],[7371574,7],[7303544,-1],[6539280,-1],[7286744,-1],[7371726,7,7371828,7,7372108,7,7372314,7],[7291578,48],[7371112,37306,7372020,37307,7372108,37310],[7345328,2500,0],[7303544,-1,-1],[7254502,-1,-1],[7155406,-1,-1],[7280358,-1,-1],[6832704,-1,-1],[7286744,-1,-1],[7216200,-1,-1],[7081318,-1,-1],null,[7365430,1599,0],[7350370,159,60],null,null,[7303544,-1,-1],[7245096,-1]]

integer

optional

Example

{
  "productType": 0,
  "asin": "B00U26V4VQ",
  "domainId": 1,
  "title": "CATAN Board Game - Embark on a Journey of Discovery and Trade! Civilization Building Strategy Game, Family Game for Kids & Adults, Ages 10+, 3-4 Players, 60-90 Minute Playtime, Made by CATAN Studio",
  "trackingSince": 2240940,
  "listedSince": 346862,
  "lastUpdate": 7376140,
  "lastRatingUpdate": 7376140,
  "lastPriceChange": 7374028,
  "lastEbayUpdate": 7374894,
  "lastStockUpdate": 7349428,
  "imagesCSV": "81zZW70yiYL.jpg,81SkwdTQypL.jpg,916rkTg6h0L.jpg,81tqU4Hr-fL.jpg,91iOb49w2fL.jpg,81rSEZZBGzL.jpg,81cnasxCU0L.jpg,51Czq2ni9IL.jpg",
  "rootCategory": 165793011,
  "categories": [
    166225011,
    19520348011,
    21394470011,
    19419995011,
    9765225011,
    24996084011,
    14052186011,
    119186712011,
    23717031011,
    24417464011,
    11308668011,
    23946859011,
    13443194011,
    19419985011
  ],
  "categoryTree": [
    {
      "catId": 165793011,
      "name": "Toys & Games"
    },
    {
      "catId": 166220011,
      "name": "Games & Accessories"
    },
    {
      "catId": 166225011,
      "name": "Board Games"
    }
  ],
  "parentAsin": "B00M0QVG3W",
  "parentAsinHistory": [
    "7367094",
    "B0CTP7MWMF"
  ],
  "variations": [
    {
      "asin": "B07GFPNJL9",
      "attributes": [
        {
          "dimension": "Size",
          "value": "7.24 LB"
        },
        {
          "dimension": "FlavorName",
          "value": "Cheddar"
        }
      ]
    }
  ],
  "frequentlyBoughtTogether": [
    "B00U26V9CU",
    "B00U26V4S4"
  ],
  "upcList": [
    "029877030712"
  ],
  "eanList": [
    "0029877030712"
  ],
  "manufacturer": "Asmodee",
  "brand": "Catan",
  "productGroup": "Toy",
  "type": "BOARD_GAME",
  "partNumber": "CN3071",
  "binding": "Board Game",
  "numberOfItems": 1,
  "numberOfPages": 514,
  "publicationDate": 20150409,
  "releaseDate": 20150423,
  "contributors": [
    [
      "Vin Diesel",
      "actor"
    ]
  ],
  "languages": [
    [
      "English"
    ],
    [
      "English",
      "Original Language"
    ]
  ],
  "model": "CN3071",
  "color": "Multicolor",
  "size": "One Size",
  "edition": "Standard Edition",
  "format": "AC-3",
  "features": [
    "EXPLORE CATAN: Set sail to the uncharted island of Catan and compete with other settlers to establish supremacy.",
    "RESOURCE MANAGEMENT: Strategically gather and trade resources like ore, brick, lumber, grain, and wool to expand your settlements.",
    "BUILD AND UPGRADE: Use your resources to build roads, settlements, and cities to earn victory points.",
    "DYNAMIC GAMEPLAY: Roll the dice to collect resources based on terrain hexes, and employ clever tactics to outmaneuver your opponents.",
    "CLASSIC GAME: Celebrate the 25th anniversary of CATAN, a timeless strategy board game loved by players worldwide."
  ],
  "description": "Your adventurous settlers seek to tame the remote but rich isle of Catan. Start by revealing Catan's many harbors and regions: pastures, fields, mountains, hills, forests, and desert. The random mix creates a different board virtually every game. Guide your settlers to victory by clever trading and cunning development. Use resource combinations- grain, wool, ore, brick, and lumber-to buy handy development cards and build roads, settlements, and cities. Acquire your resources through trades,cards, or lucky dice (even outside your turn). But beware! Someone might cut off your road or buy a monopoly. And you never know when the wily robber might steal some of your precious gains! Catan((aka The Settlers of Catan) has been awarded with \"Game of the Year,\" \"Hall of Fame,\" and even \"Game of the Century\" honors in Germany, the United States, and a host of other countries worldwide. An international favorite, it's been called the \"Perfect Social Game.\" Catan contains: 19 unique hexagonal terrain tile, 6 coastal frame pieces, 9 extra harbor pieces, 20 wooden settlements, 16 wooden cities, 60 wooden roads, 95 resource cards, 25 development cards, 4 building costs cards, 2 special bonus cards, 18 number tokens, 2 six-sided dice, 1 wooden robber pawn, simple rules & almanac.",
  "hazardousMaterials": [
    {
      "aspect": "proper_shipping_name",
      "value": "AEROSOLS"
    }
  ],
  "packageHeight": 81,
  "packageLength": 296,
  "packageWidth": 240,
  "packageWeight": 1222,
  "packageQuantity": 1,
  "itemHeight": 84,
  "itemLength": 300,
  "itemWidth": 241,
  "itemWeight": 907,
  "availabilityAmazon": 3,
  "availabilityAmazonDelay": [
    0,
    0
  ],
  "buyBoxEligibleOfferCounts": [
    3,
    2,
    0,
    0,
    0,
    0,
    0,
    0
  ],
  "competitivePriceThreshold": 2500,
  "suggestedLowerPrice": 0,
  "ebayListingIds": [
    710151859,
    325289877142
  ],
  "isAdultProduct": false,
  "isHeatSensitive": false,
  "isMerchOnDemand": true,
  "isHaul": true,
  "ingredients": "Purified Carbonated Water, Natural Flavors",
  "launchpad": true,
  "audienceRating": "PG-13 (Parents Strongly Cautioned)",
  "urlSlug": "CATAN-Board-Game-Discovery-Civilization",
  "returnRate": 0,
  "newPriceIsMAP": true,
  "isEligibleForTradeIn": false,
  "isEligibleForSuperSaverShipping": false,
  "fbaFees": {
    "pickAndPackFee": 661
  },
  "variableClosingFee": 81,
  "referralFeePercentage": 15,
  "coupon": [
    200,
    -15
  ],
  "couponHistory": [
    7339566,
    461,
    0,
    7340010,
    0,
    0,
    7356384,
    625,
    0
  ],
  "promotions": [
    {
      "type": "SNS",
      "amount": 100,
      "discountPercent": 10
    }
  ],
  "unitCount": {
    "unitValue": 1,
    "unitType": "Count",
    "eachUnitCount": 0
  },
  "salesRankReference": 165793011,
  "salesRankReferenceHistory": [
    7333764,
    165793011
  ],
  "salesRanks": {
    "165793011": [
      7371626,
      29,
      7372008,
      30,
      7372414,
      31,
      7372518,
      35
    ],
    "166225011": [
      7369930,
      1,
      7375618,
      3,
      7375864,
      2,
      7376008,
      3,
      7376106,
      2
    ]
  },
  "lastSoldUpdate": 7376384,
  "monthlySold": 20000,
  "monthlySoldHistory": [
    7375948,
    20000,
    7375956,
    30000,
    7376044,
    20000,
    7376052,
    30000,
    7376136,
    20000
  ],
  "rentalDetails": "Rented from: RentU Rental Price One Semester: $25.24 Extension Prices 15 Day: $12.61 Additional Semester: $25.24 Buyout Price: $34.89. Any rental and extension fees paid will be applied towards the buyout price of the book.",
  "rentalSellerId": "A2L77EE7U53NWQ",
  "rentalPrices": null,
  "reviews": {
    "lastUpdate": 7365044,
    "ratingCount": [
      7353286,
      34550,
      7363060,
      34590,
      7365044,
      34608
    ],
    "reviewCount": [
      7335552,
      5383,
      7339328,
      5385,
      7349412,
      5393,
      7353286,
      5396,
      7363060,
      5408,
      7365044,
      5411
    ]
  },
  "liveOffersOrder": [
    0,
    1,
    2,
    3,
    4,
    5,
    6
  ],
  "buyBoxSellerIdHistory": [
    "7339514",
    "ATVPDKIKX0DER"
  ],
  "buyBoxUsedHistory": [
    "2860926",
    "ATVPDKIKX0DER",
    "4",
    "1"
  ],
  "isRedirectASIN": false,
  "isSNS": false,
  "offersSuccessful": true,
  "offers": [
    {
      "offerId": 553,
      "lastSeen": 7376384,
      "sellerId": "A2FP3WC79CXYXU",
      "isPrime": true,
      "isFBA": true,
      "isMAP": false,
      "isShippable": true,
      "isAddonItem": false,
      "isPreorder": false,
      "isWarehouseDeal": false,
      "isScam": false,
      "shipsFromChina": false,
      "isAmazon": false,
      "isPrimeExcl": false,
      "coupon": 500,
      "couponHistory": [
        6872588,
        0
      ],
      "condition": 1,
      "conditionComment": "The item may come repackaged. Small cosmetic imperfection on top, […]",
      "offerCSV": [
        7371726,
        4999,
        0,
        7376384,
        3367,
        0
      ],
      "stockCSV": [
        7371494,
        1,
        7376140,
        2
      ],
      "primeExclCSV": [
        0
      ]
    }
  ],
  "stats": {
    "current": [
      2500,
      2500,
      -1,
      56,
      5499,
      -1,
      -1,
      4647,
      -1,
      -1,
      3367,
      7,
      -1,
      -1,
      -1,
      7,
      48,
      37323,
      2500,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      1599,
      219,
      -1,
      -1,
      -1,
      -1
    ],
    "avg": [
      2512,
      2582,
      -1,
      139,
      5499,
      -1,
      -1,
      4742,
      -1,
      -1,
      3755,
      5,
      -1,
      -1,
      -1,
      -1,
      48,
      45366,
      2512,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      1767,
      808,
      -1,
      -1,
      -1,
      -1
    ],
    "avg30": [
      2512,
      2582,
      -1,
      139,
      5499,
      -1,
      -1,
      4742,
      -1,
      -1,
      3755,
      5,
      -1,
      -1,
      -1,
      -1,
      48,
      45366,
      2512,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      1767,
      808,
      -1,
      -1,
      -1,
      -1
    ],
    "avg90": [
      3425,
      3378,
      3127,
      241,
      5601,
      4298,
      -1,
      4859,
      -1,
      3102,
      4434,
      5,
      1,
      -1,
      0,
      -1,
      48,
      45694,
      3427,
      3286,
      3176,
      -1,
      2639,
      -1,
      4298,
      -1,
      -1,
      -1,
      1767,
      1284,
      -1,
      -1,
      3279,
      -1
    ],
    "avg180": [
      3858,
      3769,
      3223,
      221,
      5800,
      4130,
      -1,
      5124,
      -1,
      3212,
      4638,
      7,
      1,
      -1,
      0,
      -1,
      48,
      45067,
      3858,
      3293,
      3184,
      3074,
      2639,
      -1,
      4162,
      2998,
      -1,
      -1,
      5078,
      1300,
      -1,
      -1,
      3276,
      3374
    ],
    "avg365": [
      4075,
      3991,
      3194,
      211,
      5813,
      3929,
      -1,
      5061,
      -1,
      3185,
      4584,
      9,
      1,
      -1,
      1,
      -1,
      48,
      43833,
      4074,
      3271,
      3132,
      3074,
      2639,
      -1,
      4248,
      3579,
      2857,
      -1,
      5899,
      1300,
      -1,
      -1,
      3269,
      3374
    ],
    "atIntervalStart": [
      2549,
      2549,
      -1,
      96,
      5499,
      -1,
      -1,
      4999,
      -1,
      -1,
      4659,
      4,
      -1,
      -1,
      -1,
      4,
      48,
      47631,
      2549,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      1701,
      -1,
      -1,
      -1,
      -1
    ],
    "min": [
      [
        4709928,
        2100
      ],
      [
        3259414,
        1
      ],
      [
        5754116,
        1825
      ],
      [
        5182524,
        2
      ],
      [
        3651144,
        3750
      ],
      [
        3449544,
        799
      ],
      null,
      [
        3189672,
        1
      ],
      [
        3523616,
        2449
      ],
      [
        5735496,
        1650
      ],
      [
        6738682,
        2099
      ],
      [
        3543146,
        1
      ],
      [
        2338720,
        1
      ],
      [
        6539248,
        0
      ],
      [
        2412158,
        1
      ],
      null,
      [
        4647484,
        42
      ],
      [
        4647484,
        16
      ],
      [
        6738680,
        2099
      ],
      [
        4710276,
        1995
      ],
      [
        4710112,
        1932
      ],
      [
        4712932,
        1969
      ],
      [
        5799036,
        1702
      ],
      [
        3506622,
        1665
      ],
      [
        4837310,
        1799
      ],
      [
        3464492,
        2495
      ],
      [
        3526988,
        2399
      ],
      null,
      [
        3226628,
        460
      ],
      [
        7350370,
        219
      ],
      null,
      null,
      [
        6267992,
        2400
      ],
      [
        6718184,
        2564
      ]
    ],
    "max": [
      [
        5633256,
        5299
      ],
      [
        3654504,
        9999
      ],
      [
        3778320,
        4476
      ],
      [
        2241840,
        66517
      ],
      [
        6609220,
        5999
      ],
      [
        2627856,
        11600
      ],
      null,
      [
        6247744,
        10489
      ],
      [
        6193860,
        3349
      ],
      [
        3779252,
        4476
      ],
      [
        4872696,
        8997
      ],
      [
        3088008,
        120
      ],
      [
        4846466,
        8
      ],
      [
        6539248,
        0
      ],
      [
        5459938,
        26
      ],
      null,
      [
        3464606,
        50
      ],
      [
        6882580,
        48772
      ],
      [
        6472404,
        7047
      ],
      [
        4249052,
        4322
      ],
      [
        3779252,
        4476
      ],
      [
        4249424,
        3881
      ],
      [
        4250884,
        3308
      ],
      [
        4870390,
        8573
      ],
      [
        3412840,
        11699
      ],
      [
        6004564,
        5500
      ],
      [
        6299472,
        5465
      ],
      null,
      [
        5230790,
        7439
      ],
      [
        3920522,
        13000
      ],
      null,
      null,
      [
        6604464,
        3907
      ],
      [
        6323572,
        4632
      ]
    ],
    "minInInterval": [
      [
        7336466,
        2500
      ],
      [
        7336466,
        2500
      ],
      [
        -1,
        -1
      ],
      [
        7357514,
        2
      ],
      [
        7333196,
        5499
      ],
      [
        -1,
        -1
      ],
      null,
      [
        7333900,
        4024
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        7341912,
        3318
      ],
      [
        7333460,
        1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      null,
      [
        7333196,
        48
      ],
      [
        7366960,
        34630
      ],
      [
        7336466,
        2500
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      null,
      [
        7365430,
        1599
      ],
      [
        7350370,
        219
      ],
      null,
      null,
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ]
    ],
    "maxInInterval": [
      [
        7333288,
        2679
      ],
      [
        7333528,
        6412
      ],
      [
        -1,
        -1
      ],
      [
        7340398,
        516
      ],
      [
        7333196,
        5499
      ],
      [
        -1,
        -1
      ],
      null,
      [
        7344566,
        5499
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        7333528,
        6412
      ],
      [
        7347928,
        9
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      null,
      [
        7333196,
        48
      ],
      [
        7366424,
        47813
      ],
      [
        7333288,
        2679
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ],
      null,
      [
        7335054,
        1999
      ],
      [
        7333196,
        1701
      ],
      null,
      null,
      [
        -1,
        -1
      ],
      [
        -1,
        -1
      ]
    ],
    "outOfStockPercentageInInterval": [
      3,
      1,
      100,
      -1,
      1,
      100,
      -1,
      6,
      100,
      100,
      10,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      3,
      100,
      100,
      100,
      100,
      100,
      100,
      100,
      100,
      -1,
      25,
      0,
      -1,
      -1,
      100,
      100
    ],
    "outOfStockPercentage30": [
      3,
      1,
      100,
      -1,
      1,
      100,
      -1,
      6,
      100,
      100,
      10,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      3,
      100,
      100,
      100,
      100,
      100,
      100,
      100,
      100,
      -1,
      25,
      0,
      -1,
      -1,
      100,
      100
    ],
    "outOfStockPercentage90": [
      2,
      1,
      92,
      -1,
      1,
      84,
      -1,
      3,
      100,
      93,
      41,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      3,
      96,
      97,
      100,
      99,
      100,
      84,
      100,
      100,
      -1,
      75,
      3,
      -1,
      -1,
      97,
      100
    ],
    "outOfStockPercentage180": [
      1,
      1,
      87,
      -1,
      1,
      90,
      -1,
      2,
      100,
      89,
      21,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      2,
      91,
      97,
      100,
      100,
      100,
      91,
      100,
      100,
      -1,
      61,
      44,
      -1,
      -1,
      93,
      98
    ],
    "outOfStockPercentage365": [
      1,
      1,
      82,
      -1,
      1,
      87,
      -1,
      2,
      100,
      84,
      11,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      -1,
      1,
      88,
      95,
      100,
      99,
      100,
      88,
      100,
      100,
      -1,
      59,
      73,
      -1,
      -1,
      89,
      99
    ],
    "salesRankDrops30": 115,
    "salesRankDrops90": 427,
    "salesRankDrops180": 935,
    "lastOffersUpdate": 7376384,
    "totalOfferCount": 7,
    "lightningDealInfo": [
      6586980,
      6589860
    ],
    "lastBuyBoxUpdate": 7376384,
    "buyBoxSellerId": "ATVPDKIKX0DER",
    "buyBoxPrice": 2500,
    "buyBoxShipping": 0,
    "buyBoxIsUnqualified": false,
    "buyBoxIsShippable": true,
    "buyBoxIsPreorder": false,
    "buyBoxIsBackorder": false,
    "buyBoxIsFBA": true,
    "buyBoxIsAmazon": true,
    "buyBoxIsMAP": true,
    "buyBoxMinOrderQuantity": 1,
    "buyBoxMaxOrderQuantity": 3,
    "buyBoxAvailabilityMessage": "In Stock.",
    "buyBoxShippingCountry": "US",
    "buyBoxIsPrimeExclusive": true,
    "buyBoxIsPrimeEligible": true,
    "buyBoxIsPrimePantry": true,
    "buyBoxStats": {
      "ATVPDKIKX0DER": {
        "percentageWon": 97.09722,
        "avgPrice": 2512,
        "avgNewOfferCount": 1,
        "avgUsedOfferCount": -1,
        "isFBA": true,
        "lastSeen": 7376396
      }
    },
    "buyBoxUsedStats": {},
    "buyBoxUsedPrice": 0,
    "buyBoxUsedShipping": 0,
    "buyBoxUsedSellerId": "A2FP3WC79CXYXU",
    "buyBoxUsedIsFBA": true,
    "buyBoxUsedCondition": 0,
    "retrievedOfferCount": -2,
    "isAddonItem": false,
    "sellerIdsLowestFBA": [
      "A2FP3WC79CXYXU"
    ],
    "sellerIdsLowestFBM": [
      "A1TSKR6QH55IJL"
    ],
    "offerCountFBA": 3,
    "offerCountFBM": 4,
    "stockAmazon": 0,
    "stockBuyBox": 0
  },
  "csv": [
    [
      7345328,
      2500
    ],
    [
      7345328,
      2500
    ],
    [
      7303544,
      -1
    ],
    [
      7371626,
      29,
      7372008,
      30,
      7372414,
      31,
      7372518,
      35
    ],
    [
      7339416,
      5499
    ],
    [
      7286744,
      -1
    ],
    null,
    [
      7362962,
      4647,
      0
    ],
    [
      6589860,
      -1
    ],
    [
      7303544,
      -1
    ],
    [
      7371726,
      4936,
      7374028,
      4931
    ],
    [
      7371574,
      7
    ],
    [
      7303544,
      -1
    ],
    [
      6539280,
      -1
    ],
    [
      7286744,
      -1
    ],
    [
      7371726,
      7,
      7371828,
      7,
      7372108,
      7,
      7372314,
      7
    ],
    [
      7291578,
      48
    ],
    [
      7371112,
      37306,
      7372020,
      37307,
      7372108,
      37310
    ],
    [
      7345328,
      2500,
      0
    ],
    [
      7303544,
      -1,
      -1
    ],
    [
      7254502,
      -1,
      -1
    ],
    [
      7155406,
      -1,
      -1
    ],
    [
      7280358,
      -1,
      -1
    ],
    [
      6832704,
      -1,
      -1
    ],
    [
      7286744,
      -1,
      -1
    ],
    [
      7216200,
      -1,
      -1
    ],
    [
      7081318,
      -1,
      -1
    ],
    null,
    [
      7365430,
      1599,
      0
    ],
    [
      7350370,
      159,
      60
    ],
    null,
    null,
    [
      7303544,
      -1,
      -1
    ],
    [
      7245096,
      -1
    ]
  ]
}

🟠400Bad Request

🟠402402

🟠403Forbidden

🟠429429

🔴500Server Error

Request

Request samples

Responses