Search Keepa products
Search for Amazon products using keywords, returning up to 100 results per search term. The results are in the same order as a search on Amazon, excluding sponsored content. By default, the product search response contains the product objects of the found products. 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/search
- Auth: one of:
- API key in query parameter api_key
- API key in header X-Api-Key
Query parameters
The term you want to search for. Should be URL encoded (https://en.wikipedia.org/wiki/Percent-encoding).
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.
If provided and set to 1, only the ASINs of the found products will be provided instead of the full product objects.
Integer value between 0 and 9. Each search result page provides up to 10 results. To retrieve more results, iterate the page parameter while keeping all other parameters identical. Start with page=0 and stop when the response contains fewer than 10 results or when you reach page=9, which is the limit.
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.
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.
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 field. Use this to reduce response size and improve processing time if you do not need the historical data.
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.
Response
Search Keepa products response
Example response
{
"products": [
{
"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.