Get Keepa product
Get detailed info of product from Keepa. The product object contains all of Keepa price history data and basic product information. The limit is 10 requests per minute.
Keepa Time Minutes. Time format used for all Keepa timestamps. To convert to an uncompressed Unix epoch time:
For milliseconds: (keepaTime + 21564000) * 60000
For seconds: (keepaTime + 21564000) * 60
Request
- Base URL: https://app.sellerassistant.app (the document declares no server; this is the origin it was published from)
- URL: https://app.sellerassistant.app/api/v1/keepa/product
- Auth: one of:
- API key in query parameter api_key
- API key in header X-Api-Key
Query parameters
The ASIN of the product you want to request. You cannot use both parameters, asin and code, in the same request.
The UPC or EAN of the product you want to request. You cannot use both parameters, asin and code, in the same request.
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.
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.
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)
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.
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.
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.
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.
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.
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).
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.
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.
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.
Response
Keepa product response
Example response
{
"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,
"ebayListingIds": [
710151859,
325289877142
],
"isMerchOnDemand": true,
"isHaul": true,
"ingredients": "Purified Carbonated Water, Natural Flavors",
"launchpad": true,
"audienceRating": "PG-13 (Parents Strongly Cautioned)",
"urlSlug": "CATAN-Board-Game-Discovery-Civilization",
"newPriceIsMAP": true,
"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"
},
"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",
"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"
],
"offersSuccessful": true,
"offers": [
{
"offerId": 553,
"lastSeen": 7376384,
"sellerId": "A2FP3WC79CXYXU",
"isPrime": true,
"isFBA": true,
"isShippable": true,
"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
]
}
],
"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,
"buyBoxIsShippable": true,
"buyBoxMinOrderQuantity": 1,
"buyBoxMaxOrderQuantity": 3,
"buyBoxAvailabilityMessage": "In Stock.",
"buyBoxShippingCountry": "US",
"buyBoxStats": {
"ATVPDKIKX0DER": {
"percentageWon": 97.09722,
"avgPrice": 2512,
"avgNewOfferCount": 1,
"avgUsedOfferCount": -1,
"isFBA": true,
"lastSeen": 7376396
}
},
"buyBoxUsedSellerId": "A2FP3WC79CXYXU",
"retrievedOfferCount": -2,
"sellerIdsLowestFBA": [
"A2FP3WC79CXYXU"
],
"sellerIdsLowestFBM": [
"A1TSKR6QH55IJL"
],
"offerCountFBA": 3,
"offerCountFBM": 4
},
"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
]
]
}Changes
No recorded changes to this operation across all 1 revision of this API.