keepa.Api Methods#
These are the core keepa classes.
- class keepa.Keepa(accesskey: str, timeout: float = 10.0, logging_level: str = 'DEBUG', check_key: bool = False)#
Synchronous Python interface to keepa data backend.
Initializes API with access key. Access key can be obtained by signing up for a reoccurring or one time plan. To obtain a key, sign up for one at Keepa Data.
- Parameters:
- accesskeystr
64 character access key string.
- timeoutfloat, default: 10.0
Default timeout when issuing any request. This is not a time limit on the entire response download; rather, an exception is raised if the server has not issued a response for timeout seconds. Setting this to 0.0 disables the timeout, but will cause any request to hang indefiantly should keepa.com be down
- logging_level: str, default: “DEBUG”
Logging level to use. Default is “DEBUG”. Other options are “INFO”, “WARNING”, “ERROR”, and “CRITICAL”.
- check_keybool, default: True
Check the keepa key on initialization and update the number of available tokens. This is a free check and does not cost any tokens, but does slow down the time to initialize. Disable this to speed up init at the risk of using an invalid key when querying for a product.
- Attributes:
time_to_refillReturn the time to refill in seconds.
Methods
best_sellers_query(category[, ...])Retrieve an ASIN list of the most popular products.
category_lookup(category_id[, domain, ...])Return root categories given a categoryId.
deals(deal_parms[, domain, wait])Query the Keepa API for product deals.
download_graph_image(asin, filename[, ...])Download the graph image of an ASIN from keepa.
product_finder(product_parms[, domain, ...])Query the keepa product database to find products matching criteria.
query(items[, stats, domain, history, ...])Perform a product query of a list, array, or single ASIN.
search_for_categories(searchterm[, domain, wait])Search for categories from Amazon.
seller_query(seller_id[, domain, ...])Receive seller information for a given seller id or ids.
Update available tokens.
Check if there are any remaining tokens and waits if none are available.
Examples
Create the api object.
>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key)
Request data from two ASINs.
>>> products = api.query(["0439064872", "1426208081"])
Print item details.
>>> print("Item 1") >>> print("\t ASIN: {:s}".format(products[0]["asin"])) >>> print("\t Title: {:s}".format(products[0]["title"])) Item 1 ASIN: 0439064872 Title: Harry Potter and the Chamber of Secrets (2)
Print item price.
>>> usedprice = products[0]["data"]["USED"] >>> usedtimes = products[0]["data"]["USED_time"] >>> print("\t Used price: ${:.2f}".format(usedprice[-1])) >>> print("\t as of: {:s}".format(str(usedtimes[-1]))) Used price: $0.52 as of: 2023-01-03 04:46:00
- best_sellers_query(category: str, rank_avg_range: Literal[0, 30, 90, 180] = 0, variations: bool = False, sublist: bool = False, domain: str | Domain = 'US', wait: bool = True)#
Retrieve an ASIN list of the most popular products.
This is based on sales in a specific category or product group. See “search_for_categories” for information on how to get a category.
Root category lists (e.g. “Home & Kitchen”) or product group lists contain up to 100,000 ASINs.
Sub-category lists (e.g. “Home Entertainment Furniture”) contain up to 3,000 ASINs. As we only have access to the product’s primary sales rank and not the ones of all categories it is listed in, the sub-category lists are created by us based on the product’s primary sales rank and do not reflect the actual ordering on Amazon.
Lists are ordered, starting with the best selling product.
Lists are updated daily. If a product does not have an accessible sales rank it will not be included in the lists. This in particular affects many products in the Clothing and Sports & Outdoors categories.
We can not correctly identify the sales rank reference category in all cases, so some products may be misplaced.
See the keepa documentation at Request Best Sellers for additional details.
- Parameters:
- categorystr
The category node id of the category you want to request the best sellers list for. You can find category node ids via the category search
Keepa.search_for_categories().- rank_avg_rangeint, default: 0
Optionally specify to retrieve a best seller list based on a sales rank average instead of the current sales rank. Valid values:
0: Use current rank
30: 30-day average
90: 90-day average
180: 180-day average
- variationsbool, default: False
Restrict list entries to a single variation for items with multiple variations. The variation returned will be the one with the highest monthly units sold (if that data point is available). When
False(default), do not include variations. WhenTrue, return all variations.By default we return one variation per parent. If the variations share the same sales rank, the representative is the variation with the highest monthly units sold. If monthly sold data is missing or tied, the representative falls back to randomly picked one.
- sublistbool, default: False
By default (
False), the best seller list for sub-categories is created based on the product’s primary sales rank, if available. To request a best seller list based on the sub-category sales rank (classification rank), set this parameter toTrue. Note that not all products have a primary sales rank or a sub-category sales rank and not all sub-category levels have sales ranks.- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- Returns:
- list
List of best seller ASINs
Examples
Query for the best sellers among the
"movies"category.>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key) >>> categories = api.search_for_categories("movies") >>> category = list(categories.items())[0][0] >>> asins = api.best_sellers_query(category) >>> asins ['B0BF3P5XZS', 'B08JQN5VDT', 'B09SP8JPPK', '0999296345', 'B07HPG684T', '1984825577', ...
Query for the best sellers among the
"movies"category using the asynchronous keepa interface.>>> import asyncio >>> import keepa >>> async def main(): ... key = "<REAL_KEEPA_KEY>" ... api = await keepa.AsyncKeepa().create(key) ... categories = await api.search_for_categories("movies") ... category = list(categories.items())[0][0] ... return await api.best_sellers_query(category) ... >>> asins = asyncio.run(main()) >>> asins ['B0BF3P5XZS', 'B08JQN5VDT', 'B09SP8JPPK', '0999296345', 'B07HPG684T', '1984825577', ...
- category_lookup(category_id: int, domain: str | Domain = 'US', include_parents=False, wait: bool = True) dict[str, Any]#
Return root categories given a categoryId.
- Parameters:
- category_idint
ID for specific category or 0 to return a list of root categories.
- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- include_parentsbool, default: False
Include parents.
- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- Returns:
- dict[str, Any]
Output format is the same as
Keepa.`search_for_categories().
Examples
Use 0 to return all root categories.
>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key) >>> categories = api.category_lookup(0)
Output the first category.
>>> list(categories.values())[0] {'domainId': 1, 'catId': 133140011, 'name': 'Kindle Store', 'children': [133141011, 133143011, 6766606011, 7529231011, 118656435011, 2268072011, 119757513011, 358606011, 3000677011, 1293747011], 'parent': 0, 'highestRank': 6984155, 'productCount': 6417325, 'contextFreeName': 'Kindle Store', 'lowestRank': 1, 'matched': True}
- deals(deal_parms: dict[str, Any], domain: str | Domain = 'US', wait: bool = True) dict[str, Any]#
Query the Keepa API for product deals.
You can find products that recently changed and match your search criteria. A single request will return a maximum of 150 deals. Try out the deals page to first get accustomed to the options: https://keepa.com/#!deals
For more details please visit: https://keepa.com/#!discuss/t/browsing-deals/338
- Parameters:
- deal_parmsdict
Dictionary containing one or more of the following keys:
"page": int"domainId": int"excludeCategories": list"includeCategories": list"priceTypes": list"deltaRange": list"deltaPercentRange": list"deltaLastRange": list"salesRankRange": list"currentRange": list"minRating": int"isLowest": bool"isLowestOffer": bool"isOutOfStock": bool"titleSearch": String"isRangeEnabled": bool"isFilterEnabled": bool"hasReviews": bool"filterErotic": bool"sortType": int"dateRange": int
- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- Returns:
- dict
Dictionary containing the deals including the following keys:
'dr'- Ordered array of all deal objects matching your query.'categoryIds'- Contains all root categoryIds of the matched deal products.'categoryNames'- Contains all root category names of the matched deal products.'categoryCount'- Contains how many deal products in the respective root category are found.
Examples
Return deals from category 16310101 using the synchronous
keepa.Keepaclass>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key) >>> deal_parms = { ... "page": 0, ... "domainId": 1, ... "excludeCategories": [1064954, 11091801], ... "includeCategories": [16310101], ... } >>> deals = api.deals(deal_parms)
Get the title of the first deal.
>>> deals["dr"][0]["title"] 'Orange Cream Rooibos, Tea Bags - Vanilla, Orange | Caffeine-Free, Antioxidant-rich, Hot & Iced | The Spice Hut, First Sip Of Tea'
Conduct the same query with the asynchronous
keepa.AsyncKeepaclass.>>> import asyncio >>> import keepa >>> deal_parms = { ... "page": 0, ... "domainId": 1, ... "excludeCategories": [1064954, 11091801], ... "includeCategories": [16310101], ... } >>> async def main(): ... key = "<REAL_KEEPA_KEY>" ... api = await keepa.AsyncKeepa().create(key) ... categories = await api.search_for_categories("movies") ... return await api.deals(deal_parms) ... >>> asins = asyncio.run(main()) >>> asins ['B0BF3P5XZS', 'B08JQN5VDT', 'B09SP8JPPK', '0999296345', 'B07HPG684T', '1984825577', ...
- download_graph_image(asin: str, filename: str | Path, domain: str | Domain = 'US', wait: bool = True, **graph_kwargs: dict[str, Any]) None#
Download the graph image of an ASIN from keepa.
See Graph Image API for more details.
- Parameters:
- asinstr
The ASIN of the product.
- filenamestr | pathlib.Path
Path to save the png to.
- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- **graph_kwargsdict[str, Any], optional
Optional graph keyword arguments. See Graph Image API for more details.
Notes
Graph images are cached for 90 minutes on a per-user basis. The cache invalidates if any parameter changes. Submitting the exact same request within this time frame will not consume any tokens.
Examples
Download a keepa graph image showing the current Amazon price, new price, and the sales rank of a product with ASIN
"B09YNQCQKR".>>> from keepa import Keepa >>> api = Keepa("<YOUR_API_KEY>") >>> api.download_graph_image( ... asin="B09YNQCQKR", ... filename="product_graph.png", ... amazon=1, ... new=1, ... salesrank=1, ... )
Show Amazon price, new and used graphs, buy box and FBA, for last 365 days, with custom width/height and custom colors. See <https://keepa.com/#!discuss/t/graph-image-api/7928>`_ for more details.
- api.download_graph_image(
asin=”B09YNQCQKR”, filename=”product_graph_365.png”, domain=”US”, amazon=1, new=1, used=1, bb=1, fba=1, range=365, width=800, height=400, cBackground=”ffffff”, cAmazon=”FFA500”, cNew=”8888dd”, cUsed=”444444”, cBB=”ff00b4”, cFBA=”ff5722”
)
- product_finder(product_parms: dict[str, Any] | ProductParams, domain: str | Domain = 'US', wait: bool = True, n_products: int = 50) list[str]#
Query the keepa product database to find products matching criteria.
Almost all product fields can be searched for and sorted.
- Parameters:
- product_parmsdict, ProductParams
Dictionary or
keepa.ProductParams.- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- n_productsint, default: 50
Maximum number of matching products returned by keepa. This can be overridden by the ‘perPage’ key in
product_parms.
- Returns:
- list[str]
List of ASINs matching the product parameters.
Notes
When using the
'sort'key in theproduct_parmsparameter, use a compatible key along with the type of sort. For example:["current_SALES", "asc"]Examples
Query for the first 100 of Jim Butcher’s books using the synchronous
keepa.Keepaclass. Sort by current sales.>>> import keepa >>> api = keepa.Keepa("<ENTER_ACTUAL_KEY_HERE>") >>> product_parms = { ... "author": "jim butcher", ... "sort": ["current_SALES", "asc"], ... } >>> asins = api.product_finder(product_parms, n_products=100) >>> asins ['B000HRMAR2', '0578799790', 'B07PW1SVHM', ... 'B003MXM744', '0133235750', 'B01MXXLJPZ']
Alternatively, use the
keepa.ProductParams:>>> product_parms = keepa.ProductParams( ... author="jim butcher", ... sort=["current_SALES", "asc"], ... ) >>> asins = api.product_finder(product_parms, n_products=100)
Query for all of Jim Butcher’s books using the asynchronous
keepa.AsyncKeepaclass.>>> import asyncio >>> import keepa >>> product_parms = {"author": "jim butcher"} >>> async def main(): ... key = "<REAL_KEEPA_KEY>" ... api = await keepa.AsyncKeepa().create(key) ... return await api.product_finder(product_parms) ... >>> asins = asyncio.run(main()) >>> asins ['B000HRMAR2', '0578799790', 'B07PW1SVHM', ... 'B003MXM744', '0133235750', 'B01MXXLJPZ']
- query(items: str | Sequence[str], stats: int | None = None, domain: str | Domain = 'US', history: bool = True, offers: int | None = None, update: int | None = None, to_datetime: bool = True, rating: bool = False, out_of_stock_as_nan: bool = True, stock: bool = False, product_code_is_asin: bool = True, progress_bar: bool = True, buybox: bool = False, wait: bool = True, days: int | None = None, only_live_offers: bool | None = None, raw: bool = False, videos: bool = False, aplus: bool = False, extra_params: dict[str, Any] | None = {}) list[dict[str, Any]]#
Perform a product query of a list, array, or single ASIN.
Returns a list of product data with one entry for each product.
- Parameters:
- itemsstr, Sequence[str]
A list, array, or single asin, UPC, EAN, or ISBN-13 identifying a product. ASINs should be 10 characters and match a product on Amazon. Items not matching Amazon product or duplicate Items will return no data. When using non-ASIN items, set
product_code_is_asintoFalse.- statsint or date, optional
No extra token cost. If specified the product object will have a stats field with quick access to current prices, min/max prices and the weighted mean values. If the offers parameter was used it will also provide stock counts and buy box information.
You can provide the stats parameter in two forms:
Last x days (positive integer value): calculates the stats of the last x days, where x is the value of the stats parameter. Interval: You can provide a date range for the stats calculation. You can specify the range via two timestamps (unix epoch time milliseconds) or two date strings (ISO8601, with or without time in UTC).
- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- historybool, optional
When set to True includes the price, sales, and offer history of a product. Set to False to reduce request time if data is not required. Default True
- offersint, optional
Adds available offers to product data. Default 0. Must be between 20 and 100. Enabling this also enables the
"buyBoxUsedHistory".- updateint, optional
If data is older than the input integer, keepa will update their database and return live data. If set to 0 (live data), request may cost an additional token. Default (
None) will not update.- to_datetimebool, default: True
When
Truecasts the time values of the product data (e.g."AMAZON_TIME") todatetime.datetime. For exampledatetime.datetime(2025, 10, 24, 10, 40). WhenFalse, the values are represented asnumpy"<M8[m]". This has no effect on pandas dataframes (e.g."df_AMAZON").- ratingbool, default: False
When set to to True, includes the existing RATING and COUNT_REVIEWS history of the csv field.
- out_of_stock_as_nanbool, default: True
When True, prices are NAN when price category is out of stock. When False, prices are -0.01.
- stockbool, default: False
Can only be used if the offers parameter is also True. If True, the stock will be collected for all retrieved live offers. Note: We can only determine stock up 10 qty. Stock retrieval takes additional time, expect the request to take longer. Existing stock history will be included whether or not the stock parameter is used.
- product_code_is_asinbool, default: True
The type of product code you are requesting. True when product code is an ASIN, an Amazon standard identification number, or ‘code’, for UPC, EAN, or ISBN-13 codes.
- progress_barbool, default: True
Display a progress bar using
tqdm.- buyboxbool, optional
Additional token cost: 2 per product). When true 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.
- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- only_live_offersbool, optional
If set to True, 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 have them removed from the response. This can improve processing time and considerably decrease the size of the response.
- daysint, optional
Any positive integer value. If specified and has positive value X the product object will limit all historical data to the recent X days. This includes the csv, buyBoxSellerIdHistory, salesRanks, offers and offers.offerCSV fields. If you do not need old historical data use this to have it removed from the response. This can improve processing time and considerably decrease the size of the response. The parameter does not use calendar days - so 1 day equals the last 24 hours. The oldest data point of each field may have a date value which is out of the specified range. This means the value of the field has not changed since that date and is still active.
- rawbool, default; False
When
True, return the raw request response. This is only available in the non-async class.- videosbool, default: False
Token Cost: No extra token cost
If
True, the videos metadata will be provided when available. Using this parameter does not trigger an update to the videos data; it only gives access to our existing data if available. If you need up-to-date data, you have to use the offers parameter.- aplusbool, default: False
Token Cost: No extra token cost
If set to
Truethe A+ content will be provided when available. Using this parameter does not trigger an update to the A+ content; it only gives access to our existing data if available. If you need up-to-date data, you have to use the offers parameter.- extra_paramsdict[str, Any], optional
Dictionary of parameters that are not specifically called out in the api. For example, a new parameters might be added to Request.java and not yet supported in this function. For example, extra_params={‘rental’: 1}.
- Returns:
- list
List of products when
raw=False. Each product within the list is a dictionary. The keys of each item may vary, so see the keys within each product for further details.Each product should contain at a minimum a “data” key containing a formatted dictionary. For the available fields see the notes section.
When
raw=True, a list of unparsed responses are returned asrequests.models.Response.
Notes
The following are some of the fields a product dictionary. For a full list and description, please see: product-object
- AMAZON
Amazon price history
- NEW
Marketplace/3rd party New price history - Amazon is considered to be part of the marketplace as well, so if Amazon has the overall lowest new (!) price, the marketplace new price in the corresponding time interval will be identical to the Amazon price (except if there is only one marketplace offer). Shipping and Handling costs not included!
- USED
Marketplace/3rd party Used price history
- SALES
Sales Rank history. Not every product has a Sales Rank.
- LISTPRICE
List Price history
- COLLECTIBLE
Collectible Price history
- REFURBISHED
Refurbished Price history
- NEW_FBM_SHIPPING
3rd party (not including Amazon) New price history including shipping costs, only fulfilled by merchant (FBM).
- LIGHTNING_DEAL
3rd party (not including Amazon) New price history including shipping costs, only fulfilled by merchant (FBM).
- WAREHOUSE
Amazon Warehouse Deals price history. Mostly of used condition, rarely new.
- NEW_FBA
Price history of the lowest 3rd party (not including Amazon/Warehouse) New offer that is fulfilled by Amazon
- COUNT_NEW
New offer count history
- COUNT_USED
Used offer count history
- COUNT_REFURBISHED
Refurbished offer count history
- COUNT_COLLECTIBLE
Collectible offer count history
- RATING
The product’s rating history. A rating is an integer from 0 to 50 (e.g. 45 = 4.5 stars)
- COUNT_REVIEWS
The product’s review count history.
- BUY_BOX_SHIPPING
The price history of the buy box. If no offer qualified for the buy box the price has the value -1. Including shipping costs.
- USED_NEW_SHIPPING
“Used - Like New” price history including shipping costs.
- USED_VERY_GOOD_SHIPPING
“Used - Very Good” price history including shipping costs.
- USED_GOOD_SHIPPING
“Used - Good” price history including shipping costs.
- USED_ACCEPTABLE_SHIPPING
“Used - Acceptable” price history including shipping costs.
- COLLECTIBLE_NEW_SHIPPING
“Collectible - Like New” price history including shipping costs.
- COLLECTIBLE_VERY_GOOD_SHIPPING
“Collectible - Very Good” price history including shipping costs.
- COLLECTIBLE_GOOD_SHIPPING
“Collectible - Good” price history including shipping costs.
- COLLECTIBLE_ACCEPTABLE_SHIPPING
“Collectible - Acceptable” price history including shipping costs.
- REFURBISHED_SHIPPING
Refurbished price history including shipping costs.
- TRADE_IN
The trade in price history. Amazon trade-in is not available for every locale.
- BUY_BOX_SHIPPING
The price history of the buy box. If no offer qualified for the buy box the price has the value -1. Including shipping costs. The
buyboxparameter must be True for this field to be in the data.
Examples
Query for product with ASIN
'B0088PUEPK'using the synchronous keepa interface.>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key) >>> response = api.query("B0088PUEPK") >>> response[0]["title"] 'Western Digital 1TB WD Blue PC Internal Hard Drive HDD - 7200 RPM, SATA 6 Gb/s, 64 MB Cache, 3.5" - WD10EZEX'
Query for product with ASIN
'B0088PUEPK'using the asynchronous keepa interface.>>> import asyncio >>> import keepa >>> async def main(): ... key = "<REAL_KEEPA_KEY>" ... api = await keepa.AsyncKeepa().create(key) ... return await api.query("B0088PUEPK") ... >>> response = asyncio.run(main()) >>> response[0]["title"] 'Western Digital 1TB WD Blue PC Internal Hard Drive HDD - 7200 RPM, SATA 6 Gb/s, 64 MB Cache, 3.5" - WD10EZEX'
Load in product offers and convert the buy box data into a
pandas.DataFrame.>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key) >>> response = api.query("B0088PUEPK", offers=20) >>> product = response[0] >>> buybox_info = product["buyBoxUsedHistory"] >>> df = keepa.process_used_buybox(buybox_info) datetime user_id condition isFBA 0 2022-11-02 16:46:00 A1QUAC68EAM09F Used - Like New True 1 2022-11-13 10:36:00 A18WXU4I7YR6UA Used - Very Good False 2 2022-11-15 23:50:00 AYUGEV9WZ4X5O Used - Like New False 3 2022-11-17 06:16:00 A18WXU4I7YR6UA Used - Very Good False 4 2022-11-17 10:56:00 AYUGEV9WZ4X5O Used - Like New False .. ... ... ... ... 115 2023-10-23 10:00:00 AYUGEV9WZ4X5O Used - Like New False 116 2023-10-25 21:14:00 A1U9HDFCZO1A84 Used - Like New False 117 2023-10-26 04:08:00 AYUGEV9WZ4X5O Used - Like New False 118 2023-10-27 08:14:00 A1U9HDFCZO1A84 Used - Like New False 119 2023-10-27 12:34:00 AYUGEV9WZ4X5O Used - Like New False
Query a video with the “videos” metadata.
>>> response = api.query("B00UFMKSDW", history=False, videos=True) >>> product = response[0] >>> "videos" in product True
- search_for_categories(searchterm: str, domain: str | Domain = 'US', wait: bool = True) dict[str, Any]#
Search for categories from Amazon.
- Parameters:
- searchtermstr
Input search term.
- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- Returns:
- dict[str, Any]
The response contains a categories dictionary with all matching categories.
Examples
Print all categories from science.
>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key) >>> categories = api.search_for_categories("science") >>> for cat_id in categories: ... print(cat_id, categories[cat_id]["name"]) ... 9091159011 Behavioral Sciences 8407535011 Fantasy, Horror & Science Fiction 8407519011 Sciences & Technology 12805 Science & Religion 13445 Astrophysics & Space Science 12038 Science Fiction & Fantasy 3207 Science, Nature & How It Works 144 Science Fiction & Fantasy
- seller_query(seller_id: str | list[str], domain: str | Domain = 'US', to_datetime: bool = True, storefront: bool = False, update: int | None = None, wait: bool = True)#
Receive seller information for a given seller id or ids.
If a seller is not found no tokens will be consumed.
Token cost: 1 per requested seller
- Parameters:
- seller_idstr or list[str]
The seller id of the merchant you want to request. For batch requests, you may submit a list of 100 seller_ids. The seller id can also be found on Amazon on seller profile pages in the seller parameter of the URL as well as in the offers results from a product query.
- domainstr | keepa.Domain, default: ‘US’
A valid Amazon domain. See
keepa.Domain.- to_datetimebool, default: True
When
Truecasts the time values todatetime.datetime. For exampledatetime.datetime(2025, 10, 24, 10, 40). WhenFalse, the values are represented asnumpy"<M8[m]".- storefrontbool, default: False
If specified the seller object will contain additional information about what items the seller is listing on Amazon. This includes a list of ASINs as well as the total amount of items the seller has listed. The following seller object fields will be set if data is available: asinList, asinListLastSeen, totalStorefrontAsinsCSV. If no data is available no additional tokens will be consumed. The ASIN list can contain up to 100,000 items. As using the storefront parameter does not trigger any new collection it does not increase the processing time of the request, though the response may be much bigger in size. The total storefront ASIN count will not be updated, only historical data will be provided (when available).
- updateint, optional
Positive integer value. If the last live data collection from the Amazon storefront page is older than update hours force a new collection. Use this parameter in conjunction with the storefront parameter. Token cost will only be applied if a new collection is triggered.
Using this parameter you can achieve the following:
Retrieve data from Amazon: a storefront ASIN list containing up to 2,400 ASINs, in addition to all ASINs already collected through our database.
Force a refresh: Always retrieve live data with the value 0.
Retrieve the total number of listings of this seller: the totalStorefrontAsinsCSV field of the seller object will be updated.
- waitbool, default: True
Wait for available tokens before querying the keepa backend.
- Returns:
- dict
Dictionary containing one entry per input
seller_id.
Notes
Seller data is not available for Amazon China.
Examples
Return the information from seller
'A2L77EE7U53NWQ'.>>> import keepa >>> key = "<REAL_KEEPA_KEY>" >>> api = keepa.Keepa(key) >>> seller_info = api.seller_query("A2L77EE7U53NWQ", "US") >>> seller_info["A2L77EE7U53NWQ"]["sellerName"] 'Amazon Warehouse'
Types#
These types and enumerators are used by keepa for data validation.
- class keepa.Domain(*values)#
Enumeration for Amazon domain regions.
Examples
>>> import keepa >>> keepa.Domain.US <Domain.US: 'US'>
- RESERVED = 'RESERVED'#
- US = 'US'#
- GB = 'GB'#
- DE = 'DE'#
- FR = 'FR'#
- JP = 'JP'#
- CA = 'CA'#
- RESERVED2 = 'RESERVED2'#
- IT = 'IT'#
- ES = 'ES'#
- IN = 'IN'#
- MX = 'MX'#
- BR = 'BR'#
- class keepa.ProductParams(*, author: list[str] | str | None = None, availabilityAmazon: list[int] | None = None, avg365_AMAZON_lte: int | None = None, avg365_AMAZON_gte: int | None = None, avg365_BUY_BOX_SHIPPING_lte: int | None = None, avg365_BUY_BOX_SHIPPING_gte: int | None = None, avg365_BUY_BOX_USED_SHIPPING_lte: int | None = None, avg365_BUY_BOX_USED_SHIPPING_gte: int | None = None, avg365_COLLECTIBLE_lte: int | None = None, avg365_COLLECTIBLE_gte: int | None = None, avg365_COUNT_COLLECTIBLE_lte: int | None = None, avg365_COUNT_COLLECTIBLE_gte: int | None = None, avg365_COUNT_NEW_lte: int | None = None, avg365_COUNT_NEW_gte: int | None = None, avg365_COUNT_REFURBISHED_lte: int | None = None, avg365_COUNT_REFURBISHED_gte: int | None = None, avg365_COUNT_REVIEWS_lte: int | None = None, avg365_COUNT_REVIEWS_gte: int | None = None, avg365_COUNT_USED_lte: int | None = None, avg365_COUNT_USED_gte: int | None = None, avg365_EBAY_NEW_SHIPPING_lte: int | None = None, avg365_EBAY_NEW_SHIPPING_gte: int | None = None, avg365_EBAY_USED_SHIPPING_lte: int | None = None, avg365_EBAY_USED_SHIPPING_gte: int | None = None, avg365_LIGHTNING_DEAL_lte: int | None = None, avg365_LIGHTNING_DEAL_gte: int | None = None, avg365_LISTPRICE_lte: int | None = None, avg365_LISTPRICE_gte: int | None = None, avg365_NEW_lte: int | None = None, avg365_NEW_gte: int | None = None, avg365_NEW_FBA_lte: int | None = None, avg365_NEW_FBA_gte: int | None = None, avg365_NEW_FBM_SHIPPING_lte: int | None = None, avg365_NEW_FBM_SHIPPING_gte: int | None = None, avg365_PRIME_EXCL_lte: int | None = None, avg365_PRIME_EXCL_gte: int | None = None, avg365_RATING_lte: int | None = None, avg365_RATING_gte: int | None = None, avg365_REFURBISHED_lte: int | None = None, avg365_REFURBISHED_gte: int | None = None, avg365_REFURBISHED_SHIPPING_lte: int | None = None, avg365_REFURBISHED_SHIPPING_gte: int | None = None, avg365_RENT_lte: int | None = None, avg365_RENT_gte: int | None = None, avg365_SALES_lte: int | None = None, avg365_SALES_gte: int | None = None, avg365_TRADE_IN_lte: int | None = None, avg365_TRADE_IN_gte: int | None = None, avg365_USED_lte: int | None = None, avg365_USED_gte: int | None = None, avg365_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, avg365_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, avg365_USED_GOOD_SHIPPING_lte: int | None = None, avg365_USED_GOOD_SHIPPING_gte: int | None = None, avg365_USED_NEW_SHIPPING_lte: int | None = None, avg365_USED_NEW_SHIPPING_gte: int | None = None, avg365_USED_VERY_GOOD_SHIPPING_lte: int | None = None, avg365_USED_VERY_GOOD_SHIPPING_gte: int | None = None, avg365_WAREHOUSE_lte: int | None = None, avg365_WAREHOUSE_gte: int | None = None, avg180_AMAZON_lte: int | None = None, avg180_AMAZON_gte: int | None = None, avg180_BUY_BOX_SHIPPING_lte: int | None = None, avg180_BUY_BOX_SHIPPING_gte: int | None = None, avg180_BUY_BOX_USED_SHIPPING_lte: int | None = None, avg180_BUY_BOX_USED_SHIPPING_gte: int | None = None, avg180_COLLECTIBLE_lte: int | None = None, avg180_COLLECTIBLE_gte: int | None = None, avg180_COUNT_COLLECTIBLE_lte: int | None = None, avg180_COUNT_COLLECTIBLE_gte: int | None = None, avg180_COUNT_NEW_lte: int | None = None, avg180_COUNT_NEW_gte: int | None = None, avg180_COUNT_REFURBISHED_lte: int | None = None, avg180_COUNT_REFURBISHED_gte: int | None = None, avg180_COUNT_REVIEWS_lte: int | None = None, avg180_COUNT_REVIEWS_gte: int | None = None, avg180_COUNT_USED_lte: int | None = None, avg180_COUNT_USED_gte: int | None = None, avg180_EBAY_NEW_SHIPPING_lte: int | None = None, avg180_EBAY_NEW_SHIPPING_gte: int | None = None, avg180_EBAY_USED_SHIPPING_lte: int | None = None, avg180_EBAY_USED_SHIPPING_gte: int | None = None, avg180_LIGHTNING_DEAL_lte: int | None = None, avg180_LIGHTNING_DEAL_gte: int | None = None, avg180_LISTPRICE_lte: int | None = None, avg180_LISTPRICE_gte: int | None = None, avg180_NEW_lte: int | None = None, avg180_NEW_gte: int | None = None, avg180_NEW_FBA_lte: int | None = None, avg180_NEW_FBA_gte: int | None = None, avg180_NEW_FBM_SHIPPING_lte: int | None = None, avg180_NEW_FBM_SHIPPING_gte: int | None = None, avg180_PRIME_EXCL_lte: int | None = None, avg180_PRIME_EXCL_gte: int | None = None, avg180_RATING_lte: int | None = None, avg180_RATING_gte: int | None = None, avg180_REFURBISHED_lte: int | None = None, avg180_REFURBISHED_gte: int | None = None, avg180_REFURBISHED_SHIPPING_lte: int | None = None, avg180_REFURBISHED_SHIPPING_gte: int | None = None, avg180_RENT_lte: int | None = None, avg180_RENT_gte: int | None = None, avg180_SALES_lte: int | None = None, avg180_SALES_gte: int | None = None, avg180_TRADE_IN_lte: int | None = None, avg180_TRADE_IN_gte: int | None = None, avg180_USED_lte: int | None = None, avg180_USED_gte: int | None = None, avg180_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, avg180_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, avg180_USED_GOOD_SHIPPING_lte: int | None = None, avg180_USED_GOOD_SHIPPING_gte: int | None = None, avg180_USED_NEW_SHIPPING_lte: int | None = None, avg180_USED_NEW_SHIPPING_gte: int | None = None, avg180_USED_VERY_GOOD_SHIPPING_lte: int | None = None, avg180_USED_VERY_GOOD_SHIPPING_gte: int | None = None, avg180_WAREHOUSE_lte: int | None = None, avg180_WAREHOUSE_gte: int | None = None, avg1_AMAZON_lte: int | None = None, avg1_AMAZON_gte: int | None = None, avg1_BUY_BOX_SHIPPING_lte: int | None = None, avg1_BUY_BOX_SHIPPING_gte: int | None = None, avg1_BUY_BOX_USED_SHIPPING_lte: int | None = None, avg1_BUY_BOX_USED_SHIPPING_gte: int | None = None, avg1_COLLECTIBLE_lte: int | None = None, avg1_COLLECTIBLE_gte: int | None = None, avg1_COUNT_COLLECTIBLE_lte: int | None = None, avg1_COUNT_COLLECTIBLE_gte: int | None = None, avg1_COUNT_NEW_lte: int | None = None, avg1_COUNT_NEW_gte: int | None = None, avg1_COUNT_REFURBISHED_lte: int | None = None, avg1_COUNT_REFURBISHED_gte: int | None = None, avg1_COUNT_REVIEWS_lte: int | None = None, avg1_COUNT_REVIEWS_gte: int | None = None, avg1_COUNT_USED_lte: int | None = None, avg1_COUNT_USED_gte: int | None = None, avg1_EBAY_NEW_SHIPPING_lte: int | None = None, avg1_EBAY_NEW_SHIPPING_gte: int | None = None, avg1_EBAY_USED_SHIPPING_lte: int | None = None, avg1_EBAY_USED_SHIPPING_gte: int | None = None, avg1_LIGHTNING_DEAL_lte: int | None = None, avg1_LIGHTNING_DEAL_gte: int | None = None, avg1_LISTPRICE_lte: int | None = None, avg1_LISTPRICE_gte: int | None = None, avg1_NEW_lte: int | None = None, avg1_NEW_gte: int | None = None, avg1_NEW_FBA_lte: int | None = None, avg1_NEW_FBA_gte: int | None = None, avg1_NEW_FBM_SHIPPING_lte: int | None = None, avg1_NEW_FBM_SHIPPING_gte: int | None = None, avg1_PRIME_EXCL_lte: int | None = None, avg1_PRIME_EXCL_gte: int | None = None, avg1_RATING_lte: int | None = None, avg1_RATING_gte: int | None = None, avg1_REFURBISHED_lte: int | None = None, avg1_REFURBISHED_gte: int | None = None, avg1_REFURBISHED_SHIPPING_lte: int | None = None, avg1_REFURBISHED_SHIPPING_gte: int | None = None, avg1_RENT_lte: int | None = None, avg1_RENT_gte: int | None = None, avg1_SALES_lte: int | None = None, avg1_SALES_gte: int | None = None, avg1_TRADE_IN_lte: int | None = None, avg1_TRADE_IN_gte: int | None = None, avg1_USED_lte: int | None = None, avg1_USED_gte: int | None = None, avg1_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, avg1_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, avg1_USED_GOOD_SHIPPING_lte: int | None = None, avg1_USED_GOOD_SHIPPING_gte: int | None = None, avg1_USED_NEW_SHIPPING_lte: int | None = None, avg1_USED_NEW_SHIPPING_gte: int | None = None, avg1_USED_VERY_GOOD_SHIPPING_lte: int | None = None, avg1_USED_VERY_GOOD_SHIPPING_gte: int | None = None, avg1_WAREHOUSE_lte: int | None = None, avg1_WAREHOUSE_gte: int | None = None, avg30_AMAZON_lte: int | None = None, avg30_AMAZON_gte: int | None = None, avg30_BUY_BOX_SHIPPING_lte: int | None = None, avg30_BUY_BOX_SHIPPING_gte: int | None = None, avg30_BUY_BOX_USED_SHIPPING_lte: int | None = None, avg30_BUY_BOX_USED_SHIPPING_gte: int | None = None, avg30_COLLECTIBLE_lte: int | None = None, avg30_COLLECTIBLE_gte: int | None = None, avg30_COUNT_COLLECTIBLE_lte: int | None = None, avg30_COUNT_COLLECTIBLE_gte: int | None = None, avg30_COUNT_NEW_lte: int | None = None, avg30_COUNT_NEW_gte: int | None = None, avg30_COUNT_REFURBISHED_lte: int | None = None, avg30_COUNT_REFURBISHED_gte: int | None = None, avg30_COUNT_REVIEWS_lte: int | None = None, avg30_COUNT_REVIEWS_gte: int | None = None, avg30_COUNT_USED_lte: int | None = None, avg30_COUNT_USED_gte: int | None = None, avg30_EBAY_NEW_SHIPPING_lte: int | None = None, avg30_EBAY_NEW_SHIPPING_gte: int | None = None, avg30_EBAY_USED_SHIPPING_lte: int | None = None, avg30_EBAY_USED_SHIPPING_gte: int | None = None, avg30_LIGHTNING_DEAL_lte: int | None = None, avg30_LIGHTNING_DEAL_gte: int | None = None, avg30_LISTPRICE_lte: int | None = None, avg30_LISTPRICE_gte: int | None = None, avg30_NEW_lte: int | None = None, avg30_NEW_gte: int | None = None, avg30_NEW_FBA_lte: int | None = None, avg30_NEW_FBA_gte: int | None = None, avg30_NEW_FBM_SHIPPING_lte: int | None = None, avg30_NEW_FBM_SHIPPING_gte: int | None = None, avg30_PRIME_EXCL_lte: int | None = None, avg30_PRIME_EXCL_gte: int | None = None, avg30_RATING_lte: int | None = None, avg30_RATING_gte: int | None = None, avg30_REFURBISHED_lte: int | None = None, avg30_REFURBISHED_gte: int | None = None, avg30_REFURBISHED_SHIPPING_lte: int | None = None, avg30_REFURBISHED_SHIPPING_gte: int | None = None, avg30_RENT_lte: int | None = None, avg30_RENT_gte: int | None = None, avg30_SALES_lte: int | None = None, avg30_SALES_gte: int | None = None, avg30_TRADE_IN_lte: int | None = None, avg30_TRADE_IN_gte: int | None = None, avg30_USED_lte: int | None = None, avg30_USED_gte: int | None = None, avg30_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, avg30_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, avg30_USED_GOOD_SHIPPING_lte: int | None = None, avg30_USED_GOOD_SHIPPING_gte: int | None = None, avg30_USED_NEW_SHIPPING_lte: int | None = None, avg30_USED_NEW_SHIPPING_gte: int | None = None, avg30_USED_VERY_GOOD_SHIPPING_lte: int | None = None, avg30_USED_VERY_GOOD_SHIPPING_gte: int | None = None, avg30_WAREHOUSE_lte: int | None = None, avg30_WAREHOUSE_gte: int | None = None, avg7_AMAZON_lte: int | None = None, avg7_AMAZON_gte: int | None = None, avg7_BUY_BOX_SHIPPING_lte: int | None = None, avg7_BUY_BOX_SHIPPING_gte: int | None = None, avg7_BUY_BOX_USED_SHIPPING_lte: int | None = None, avg7_BUY_BOX_USED_SHIPPING_gte: int | None = None, avg7_COLLECTIBLE_lte: int | None = None, avg7_COLLECTIBLE_gte: int | None = None, avg7_COUNT_COLLECTIBLE_lte: int | None = None, avg7_COUNT_COLLECTIBLE_gte: int | None = None, avg7_COUNT_NEW_lte: int | None = None, avg7_COUNT_NEW_gte: int | None = None, avg7_COUNT_REFURBISHED_lte: int | None = None, avg7_COUNT_REFURBISHED_gte: int | None = None, avg7_COUNT_REVIEWS_lte: int | None = None, avg7_COUNT_REVIEWS_gte: int | None = None, avg7_COUNT_USED_lte: int | None = None, avg7_COUNT_USED_gte: int | None = None, avg7_EBAY_NEW_SHIPPING_lte: int | None = None, avg7_EBAY_NEW_SHIPPING_gte: int | None = None, avg7_EBAY_USED_SHIPPING_lte: int | None = None, avg7_EBAY_USED_SHIPPING_gte: int | None = None, avg7_LIGHTNING_DEAL_lte: int | None = None, avg7_LIGHTNING_DEAL_gte: int | None = None, avg7_LISTPRICE_lte: int | None = None, avg7_LISTPRICE_gte: int | None = None, avg7_NEW_lte: int | None = None, avg7_NEW_gte: int | None = None, avg7_NEW_FBA_lte: int | None = None, avg7_NEW_FBA_gte: int | None = None, avg7_NEW_FBM_SHIPPING_lte: int | None = None, avg7_NEW_FBM_SHIPPING_gte: int | None = None, avg7_PRIME_EXCL_lte: int | None = None, avg7_PRIME_EXCL_gte: int | None = None, avg7_RATING_lte: int | None = None, avg7_RATING_gte: int | None = None, avg7_REFURBISHED_lte: int | None = None, avg7_REFURBISHED_gte: int | None = None, avg7_REFURBISHED_SHIPPING_lte: int | None = None, avg7_REFURBISHED_SHIPPING_gte: int | None = None, avg7_RENT_lte: int | None = None, avg7_RENT_gte: int | None = None, avg7_SALES_lte: int | None = None, avg7_SALES_gte: int | None = None, avg7_TRADE_IN_lte: int | None = None, avg7_TRADE_IN_gte: int | None = None, avg7_USED_lte: int | None = None, avg7_USED_gte: int | None = None, avg7_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, avg7_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, avg7_USED_GOOD_SHIPPING_lte: int | None = None, avg7_USED_GOOD_SHIPPING_gte: int | None = None, avg7_USED_NEW_SHIPPING_lte: int | None = None, avg7_USED_NEW_SHIPPING_gte: int | None = None, avg7_USED_VERY_GOOD_SHIPPING_lte: int | None = None, avg7_USED_VERY_GOOD_SHIPPING_gte: int | None = None, avg7_WAREHOUSE_lte: int | None = None, avg7_WAREHOUSE_gte: int | None = None, avg90_AMAZON_lte: int | None = None, avg90_AMAZON_gte: int | None = None, avg90_BUY_BOX_SHIPPING_lte: int | None = None, avg90_BUY_BOX_SHIPPING_gte: int | None = None, avg90_BUY_BOX_USED_SHIPPING_lte: int | None = None, avg90_BUY_BOX_USED_SHIPPING_gte: int | None = None, avg90_COLLECTIBLE_lte: int | None = None, avg90_COLLECTIBLE_gte: int | None = None, avg90_COUNT_COLLECTIBLE_lte: int | None = None, avg90_COUNT_COLLECTIBLE_gte: int | None = None, avg90_COUNT_NEW_lte: int | None = None, avg90_COUNT_NEW_gte: int | None = None, avg90_COUNT_REFURBISHED_lte: int | None = None, avg90_COUNT_REFURBISHED_gte: int | None = None, avg90_COUNT_REVIEWS_lte: int | None = None, avg90_COUNT_REVIEWS_gte: int | None = None, avg90_COUNT_USED_lte: int | None = None, avg90_COUNT_USED_gte: int | None = None, avg90_EBAY_NEW_SHIPPING_lte: int | None = None, avg90_EBAY_NEW_SHIPPING_gte: int | None = None, avg90_EBAY_USED_SHIPPING_lte: int | None = None, avg90_EBAY_USED_SHIPPING_gte: int | None = None, avg90_LIGHTNING_DEAL_lte: int | None = None, avg90_LIGHTNING_DEAL_gte: int | None = None, avg90_LISTPRICE_lte: int | None = None, avg90_LISTPRICE_gte: int | None = None, avg90_NEW_lte: int | None = None, avg90_NEW_gte: int | None = None, avg90_NEW_FBA_lte: int | None = None, avg90_NEW_FBA_gte: int | None = None, avg90_NEW_FBM_SHIPPING_lte: int | None = None, avg90_NEW_FBM_SHIPPING_gte: int | None = None, avg90_PRIME_EXCL_lte: int | None = None, avg90_PRIME_EXCL_gte: int | None = None, avg90_RATING_lte: int | None = None, avg90_RATING_gte: int | None = None, avg90_REFURBISHED_lte: int | None = None, avg90_REFURBISHED_gte: int | None = None, avg90_REFURBISHED_SHIPPING_lte: int | None = None, avg90_REFURBISHED_SHIPPING_gte: int | None = None, avg90_RENT_lte: int | None = None, avg90_RENT_gte: int | None = None, avg90_SALES_lte: int | None = None, avg90_SALES_gte: int | None = None, avg90_TRADE_IN_lte: int | None = None, avg90_TRADE_IN_gte: int | None = None, avg90_USED_lte: int | None = None, avg90_USED_gte: int | None = None, avg90_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, avg90_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, avg90_USED_GOOD_SHIPPING_lte: int | None = None, avg90_USED_GOOD_SHIPPING_gte: int | None = None, avg90_USED_NEW_SHIPPING_lte: int | None = None, avg90_USED_NEW_SHIPPING_gte: int | None = None, avg90_USED_VERY_GOOD_SHIPPING_lte: int | None = None, avg90_USED_VERY_GOOD_SHIPPING_gte: int | None = None, avg90_WAREHOUSE_lte: int | None = None, avg90_WAREHOUSE_gte: int | None = None, backInStock_AMAZON: bool | None = None, backInStock_BUY_BOX_SHIPPING: bool | None = None, backInStock_BUY_BOX_USED_SHIPPING: bool | None = None, backInStock_COLLECTIBLE: bool | None = None, backInStock_COUNT_COLLECTIBLE: bool | None = None, backInStock_COUNT_NEW: bool | None = None, backInStock_COUNT_REFURBISHED: bool | None = None, backInStock_COUNT_REVIEWS: bool | None = None, backInStock_COUNT_USED: bool | None = None, backInStock_EBAY_NEW_SHIPPING: bool | None = None, backInStock_EBAY_USED_SHIPPING: bool | None = None, backInStock_LIGHTNING_DEAL: bool | None = None, backInStock_LISTPRICE: bool | None = None, backInStock_NEW: bool | None = None, backInStock_NEW_FBA: bool | None = None, backInStock_NEW_FBM_SHIPPING: bool | None = None, backInStock_PRIME_EXCL: bool | None = None, backInStock_RATING: bool | None = None, backInStock_REFURBISHED: bool | None = None, backInStock_REFURBISHED_SHIPPING: bool | None = None, backInStock_RENT: bool | None = None, backInStock_SALES: bool | None = None, backInStock_TRADE_IN: bool | None = None, backInStock_USED: bool | None = None, backInStock_USED_ACCEPTABLE_SHIPPING: bool | None = None, backInStock_USED_GOOD_SHIPPING: bool | None = None, backInStock_USED_NEW_SHIPPING: bool | None = None, backInStock_USED_VERY_GOOD_SHIPPING: bool | None = None, backInStock_WAREHOUSE: bool | None = None, binding: list[str] | str | None = None, brand: list[str] | str | None = None, dealType: list[str] | str | None = None, buyBoxIsAmazon: bool | None = None, buyBoxIsFBA: bool | None = None, buyBoxIsUnqualified: bool | None = None, buyBoxSellerId: list[str] | str | None = None, buyBoxUsedCondition: list[int] | None = None, buyBoxUsedIsFBA: bool | None = None, buyBoxUsedSellerId: str | None = None, categories_include: list[Any] | None = None, categories_exclude: list[Any] | None = None, color: list[str] | str | None = None, historicalParentASIN: str | None = None, couponOneTimeAbsolute_lte: int | None = None, couponOneTimeAbsolute_gte: int | None = None, couponOneTimePercent_lte: int | None = None, couponOneTimePercent_gte: int | None = None, couponSNSPercent_lte: int | None = None, couponSNSPercent_gte: int | None = None, current_AMAZON_lte: int | None = None, current_AMAZON_gte: int | None = None, current_BUY_BOX_SHIPPING_lte: int | None = None, current_BUY_BOX_SHIPPING_gte: int | None = None, current_BUY_BOX_USED_SHIPPING_lte: int | None = None, current_BUY_BOX_USED_SHIPPING_gte: int | None = None, current_COLLECTIBLE_lte: int | None = None, current_COLLECTIBLE_gte: int | None = None, current_COUNT_COLLECTIBLE_lte: int | None = None, current_COUNT_COLLECTIBLE_gte: int | None = None, current_COUNT_NEW_lte: int | None = None, current_COUNT_NEW_gte: int | None = None, current_COUNT_REFURBISHED_lte: int | None = None, current_COUNT_REFURBISHED_gte: int | None = None, current_COUNT_REVIEWS_lte: int | None = None, current_COUNT_REVIEWS_gte: int | None = None, current_COUNT_USED_lte: int | None = None, current_COUNT_USED_gte: int | None = None, current_EBAY_NEW_SHIPPING_lte: int | None = None, current_EBAY_NEW_SHIPPING_gte: int | None = None, current_EBAY_USED_SHIPPING_lte: int | None = None, current_EBAY_USED_SHIPPING_gte: int | None = None, current_LIGHTNING_DEAL_lte: int | None = None, current_LIGHTNING_DEAL_gte: int | None = None, current_LISTPRICE_lte: int | None = None, current_LISTPRICE_gte: int | None = None, current_NEW_lte: int | None = None, current_NEW_gte: int | None = None, current_NEW_FBA_lte: int | None = None, current_NEW_FBA_gte: int | None = None, current_NEW_FBM_SHIPPING_lte: int | None = None, current_NEW_FBM_SHIPPING_gte: int | None = None, current_PRIME_EXCL_lte: int | None = None, current_PRIME_EXCL_gte: int | None = None, current_RATING_lte: int | None = None, current_RATING_gte: int | None = None, current_REFURBISHED_lte: int | None = None, current_REFURBISHED_gte: int | None = None, current_REFURBISHED_SHIPPING_lte: int | None = None, current_REFURBISHED_SHIPPING_gte: int | None = None, current_RENT_lte: int | None = None, current_RENT_gte: int | None = None, current_SALES_lte: int | None = None, current_SALES_gte: int | None = None, current_TRADE_IN_lte: int | None = None, current_TRADE_IN_gte: int | None = None, current_USED_lte: int | None = None, current_USED_gte: int | None = None, current_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, current_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, current_USED_GOOD_SHIPPING_lte: int | None = None, current_USED_GOOD_SHIPPING_gte: int | None = None, current_USED_NEW_SHIPPING_lte: int | None = None, current_USED_NEW_SHIPPING_gte: int | None = None, current_USED_VERY_GOOD_SHIPPING_lte: int | None = None, current_USED_VERY_GOOD_SHIPPING_gte: int | None = None, current_WAREHOUSE_lte: int | None = None, current_WAREHOUSE_gte: int | None = None, delta1_AMAZON_lte: int | None = None, delta1_AMAZON_gte: int | None = None, delta1_BUY_BOX_SHIPPING_lte: int | None = None, delta1_BUY_BOX_SHIPPING_gte: int | None = None, delta1_BUY_BOX_USED_SHIPPING_lte: int | None = None, delta1_BUY_BOX_USED_SHIPPING_gte: int | None = None, delta1_COLLECTIBLE_lte: int | None = None, delta1_COLLECTIBLE_gte: int | None = None, delta1_COUNT_COLLECTIBLE_lte: int | None = None, delta1_COUNT_COLLECTIBLE_gte: int | None = None, delta1_COUNT_NEW_lte: int | None = None, delta1_COUNT_NEW_gte: int | None = None, delta1_COUNT_REFURBISHED_lte: int | None = None, delta1_COUNT_REFURBISHED_gte: int | None = None, delta1_COUNT_REVIEWS_lte: int | None = None, delta1_COUNT_REVIEWS_gte: int | None = None, delta1_COUNT_USED_lte: int | None = None, delta1_COUNT_USED_gte: int | None = None, delta1_EBAY_NEW_SHIPPING_lte: int | None = None, delta1_EBAY_NEW_SHIPPING_gte: int | None = None, delta1_EBAY_USED_SHIPPING_lte: int | None = None, delta1_EBAY_USED_SHIPPING_gte: int | None = None, delta1_LIGHTNING_DEAL_lte: int | None = None, delta1_LIGHTNING_DEAL_gte: int | None = None, delta1_LISTPRICE_lte: int | None = None, delta1_LISTPRICE_gte: int | None = None, delta1_NEW_lte: int | None = None, delta1_NEW_gte: int | None = None, delta1_NEW_FBA_lte: int | None = None, delta1_NEW_FBA_gte: int | None = None, delta1_NEW_FBM_SHIPPING_lte: int | None = None, delta1_NEW_FBM_SHIPPING_gte: int | None = None, delta1_PRIME_EXCL_lte: int | None = None, delta1_PRIME_EXCL_gte: int | None = None, delta1_RATING_lte: int | None = None, delta1_RATING_gte: int | None = None, delta1_REFURBISHED_lte: int | None = None, delta1_REFURBISHED_gte: int | None = None, delta1_REFURBISHED_SHIPPING_lte: int | None = None, delta1_REFURBISHED_SHIPPING_gte: int | None = None, delta1_RENT_lte: int | None = None, delta1_RENT_gte: int | None = None, delta1_SALES_lte: int | None = None, delta1_SALES_gte: int | None = None, delta1_TRADE_IN_lte: int | None = None, delta1_TRADE_IN_gte: int | None = None, delta1_USED_lte: int | None = None, delta1_USED_gte: int | None = None, delta1_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, delta1_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, delta1_USED_GOOD_SHIPPING_lte: int | None = None, delta1_USED_GOOD_SHIPPING_gte: int | None = None, delta1_USED_NEW_SHIPPING_lte: int | None = None, delta1_USED_NEW_SHIPPING_gte: int | None = None, delta1_USED_VERY_GOOD_SHIPPING_lte: int | None = None, delta1_USED_VERY_GOOD_SHIPPING_gte: int | None = None, delta1_WAREHOUSE_lte: int | None = None, delta1_WAREHOUSE_gte: int | None = None, delta30_AMAZON_lte: int | None = None, delta30_AMAZON_gte: int | None = None, delta30_BUY_BOX_SHIPPING_lte: int | None = None, delta30_BUY_BOX_SHIPPING_gte: int | None = None, delta30_BUY_BOX_USED_SHIPPING_lte: int | None = None, delta30_BUY_BOX_USED_SHIPPING_gte: int | None = None, delta30_COLLECTIBLE_lte: int | None = None, delta30_COLLECTIBLE_gte: int | None = None, delta30_COUNT_COLLECTIBLE_lte: int | None = None, delta30_COUNT_COLLECTIBLE_gte: int | None = None, delta30_COUNT_NEW_lte: int | None = None, delta30_COUNT_NEW_gte: int | None = None, delta30_COUNT_REFURBISHED_lte: int | None = None, delta30_COUNT_REFURBISHED_gte: int | None = None, delta30_COUNT_REVIEWS_lte: int | None = None, delta30_COUNT_REVIEWS_gte: int | None = None, delta30_COUNT_USED_lte: int | None = None, delta30_COUNT_USED_gte: int | None = None, delta30_EBAY_NEW_SHIPPING_lte: int | None = None, delta30_EBAY_NEW_SHIPPING_gte: int | None = None, delta30_EBAY_USED_SHIPPING_lte: int | None = None, delta30_EBAY_USED_SHIPPING_gte: int | None = None, delta30_LIGHTNING_DEAL_lte: int | None = None, delta30_LIGHTNING_DEAL_gte: int | None = None, delta30_LISTPRICE_lte: int | None = None, delta30_LISTPRICE_gte: int | None = None, delta30_NEW_lte: int | None = None, delta30_NEW_gte: int | None = None, delta30_NEW_FBA_lte: int | None = None, delta30_NEW_FBA_gte: int | None = None, delta30_NEW_FBM_SHIPPING_lte: int | None = None, delta30_NEW_FBM_SHIPPING_gte: int | None = None, delta30_PRIME_EXCL_lte: int | None = None, delta30_PRIME_EXCL_gte: int | None = None, delta30_RATING_lte: int | None = None, delta30_RATING_gte: int | None = None, delta30_REFURBISHED_lte: int | None = None, delta30_REFURBISHED_gte: int | None = None, delta30_REFURBISHED_SHIPPING_lte: int | None = None, delta30_REFURBISHED_SHIPPING_gte: int | None = None, delta30_RENT_lte: int | None = None, delta30_RENT_gte: int | None = None, delta30_SALES_lte: int | None = None, delta30_SALES_gte: int | None = None, delta30_TRADE_IN_lte: int | None = None, delta30_TRADE_IN_gte: int | None = None, delta30_USED_lte: int | None = None, delta30_USED_gte: int | None = None, delta30_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, delta30_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, delta30_USED_GOOD_SHIPPING_lte: int | None = None, delta30_USED_GOOD_SHIPPING_gte: int | None = None, delta30_USED_NEW_SHIPPING_lte: int | None = None, delta30_USED_NEW_SHIPPING_gte: int | None = None, delta30_USED_VERY_GOOD_SHIPPING_lte: int | None = None, delta30_USED_VERY_GOOD_SHIPPING_gte: int | None = None, delta30_WAREHOUSE_lte: int | None = None, delta30_WAREHOUSE_gte: int | None = None, delta7_AMAZON_lte: int | None = None, delta7_AMAZON_gte: int | None = None, delta7_BUY_BOX_SHIPPING_lte: int | None = None, delta7_BUY_BOX_SHIPPING_gte: int | None = None, delta7_BUY_BOX_USED_SHIPPING_lte: int | None = None, delta7_BUY_BOX_USED_SHIPPING_gte: int | None = None, delta7_COLLECTIBLE_lte: int | None = None, delta7_COLLECTIBLE_gte: int | None = None, delta7_COUNT_COLLECTIBLE_lte: int | None = None, delta7_COUNT_COLLECTIBLE_gte: int | None = None, delta7_COUNT_NEW_lte: int | None = None, delta7_COUNT_NEW_gte: int | None = None, delta7_COUNT_REFURBISHED_lte: int | None = None, delta7_COUNT_REFURBISHED_gte: int | None = None, delta7_COUNT_REVIEWS_lte: int | None = None, delta7_COUNT_REVIEWS_gte: int | None = None, delta7_COUNT_USED_lte: int | None = None, delta7_COUNT_USED_gte: int | None = None, delta7_EBAY_NEW_SHIPPING_lte: int | None = None, delta7_EBAY_NEW_SHIPPING_gte: int | None = None, delta7_EBAY_USED_SHIPPING_lte: int | None = None, delta7_EBAY_USED_SHIPPING_gte: int | None = None, delta7_LIGHTNING_DEAL_lte: int | None = None, delta7_LIGHTNING_DEAL_gte: int | None = None, delta7_LISTPRICE_lte: int | None = None, delta7_LISTPRICE_gte: int | None = None, delta7_NEW_lte: int | None = None, delta7_NEW_gte: int | None = None, delta7_NEW_FBA_lte: int | None = None, delta7_NEW_FBA_gte: int | None = None, delta7_NEW_FBM_SHIPPING_lte: int | None = None, delta7_NEW_FBM_SHIPPING_gte: int | None = None, delta7_PRIME_EXCL_lte: int | None = None, delta7_PRIME_EXCL_gte: int | None = None, delta7_RATING_lte: int | None = None, delta7_RATING_gte: int | None = None, delta7_REFURBISHED_lte: int | None = None, delta7_REFURBISHED_gte: int | None = None, delta7_REFURBISHED_SHIPPING_lte: int | None = None, delta7_REFURBISHED_SHIPPING_gte: int | None = None, delta7_RENT_lte: int | None = None, delta7_RENT_gte: int | None = None, delta7_SALES_lte: int | None = None, delta7_SALES_gte: int | None = None, delta7_TRADE_IN_lte: int | None = None, delta7_TRADE_IN_gte: int | None = None, delta7_USED_lte: int | None = None, delta7_USED_gte: int | None = None, delta7_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, delta7_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, delta7_USED_GOOD_SHIPPING_lte: int | None = None, delta7_USED_GOOD_SHIPPING_gte: int | None = None, delta7_USED_NEW_SHIPPING_lte: int | None = None, delta7_USED_NEW_SHIPPING_gte: int | None = None, delta7_USED_VERY_GOOD_SHIPPING_lte: int | None = None, delta7_USED_VERY_GOOD_SHIPPING_gte: int | None = None, delta7_WAREHOUSE_lte: int | None = None, delta7_WAREHOUSE_gte: int | None = None, delta90_AMAZON_lte: int | None = None, delta90_AMAZON_gte: int | None = None, delta90_BUY_BOX_SHIPPING_lte: int | None = None, delta90_BUY_BOX_SHIPPING_gte: int | None = None, delta90_BUY_BOX_USED_SHIPPING_lte: int | None = None, delta90_BUY_BOX_USED_SHIPPING_gte: int | None = None, delta90_COLLECTIBLE_lte: int | None = None, delta90_COLLECTIBLE_gte: int | None = None, delta90_COUNT_COLLECTIBLE_lte: int | None = None, delta90_COUNT_COLLECTIBLE_gte: int | None = None, delta90_COUNT_NEW_lte: int | None = None, delta90_COUNT_NEW_gte: int | None = None, delta90_COUNT_REFURBISHED_lte: int | None = None, delta90_COUNT_REFURBISHED_gte: int | None = None, delta90_COUNT_REVIEWS_lte: int | None = None, delta90_COUNT_REVIEWS_gte: int | None = None, delta90_COUNT_USED_lte: int | None = None, delta90_COUNT_USED_gte: int | None = None, delta90_EBAY_NEW_SHIPPING_lte: int | None = None, delta90_EBAY_NEW_SHIPPING_gte: int | None = None, delta90_EBAY_USED_SHIPPING_lte: int | None = None, delta90_EBAY_USED_SHIPPING_gte: int | None = None, delta90_LIGHTNING_DEAL_lte: int | None = None, delta90_LIGHTNING_DEAL_gte: int | None = None, delta90_LISTPRICE_lte: int | None = None, delta90_LISTPRICE_gte: int | None = None, delta90_NEW_lte: int | None = None, delta90_NEW_gte: int | None = None, delta90_NEW_FBA_lte: int | None = None, delta90_NEW_FBA_gte: int | None = None, delta90_NEW_FBM_SHIPPING_lte: int | None = None, delta90_NEW_FBM_SHIPPING_gte: int | None = None, delta90_PRIME_EXCL_lte: int | None = None, delta90_PRIME_EXCL_gte: int | None = None, delta90_RATING_lte: int | None = None, delta90_RATING_gte: int | None = None, delta90_REFURBISHED_lte: int | None = None, delta90_REFURBISHED_gte: int | None = None, delta90_REFURBISHED_SHIPPING_lte: int | None = None, delta90_REFURBISHED_SHIPPING_gte: int | None = None, delta90_RENT_lte: int | None = None, delta90_RENT_gte: int | None = None, delta90_SALES_lte: int | None = None, delta90_SALES_gte: int | None = None, delta90_TRADE_IN_lte: int | None = None, delta90_TRADE_IN_gte: int | None = None, delta90_USED_lte: int | None = None, delta90_USED_gte: int | None = None, delta90_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, delta90_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, delta90_USED_GOOD_SHIPPING_lte: int | None = None, delta90_USED_GOOD_SHIPPING_gte: int | None = None, delta90_USED_NEW_SHIPPING_lte: int | None = None, delta90_USED_NEW_SHIPPING_gte: int | None = None, delta90_USED_VERY_GOOD_SHIPPING_lte: int | None = None, delta90_USED_VERY_GOOD_SHIPPING_gte: int | None = None, delta90_WAREHOUSE_lte: int | None = None, delta90_WAREHOUSE_gte: int | None = None, deltaLast_AMAZON_lte: int | None = None, deltaLast_AMAZON_gte: int | None = None, deltaLast_BUY_BOX_SHIPPING_lte: int | None = None, deltaLast_BUY_BOX_SHIPPING_gte: int | None = None, deltaLast_BUY_BOX_USED_SHIPPING_lte: int | None = None, deltaLast_BUY_BOX_USED_SHIPPING_gte: int | None = None, deltaLast_COLLECTIBLE_lte: int | None = None, deltaLast_COLLECTIBLE_gte: int | None = None, deltaLast_COUNT_COLLECTIBLE_lte: int | None = None, deltaLast_COUNT_COLLECTIBLE_gte: int | None = None, deltaLast_COUNT_NEW_lte: int | None = None, deltaLast_COUNT_NEW_gte: int | None = None, deltaLast_COUNT_REFURBISHED_lte: int | None = None, deltaLast_COUNT_REFURBISHED_gte: int | None = None, deltaLast_COUNT_REVIEWS_lte: int | None = None, deltaLast_COUNT_REVIEWS_gte: int | None = None, deltaLast_COUNT_USED_lte: int | None = None, deltaLast_COUNT_USED_gte: int | None = None, deltaLast_EBAY_NEW_SHIPPING_lte: int | None = None, deltaLast_EBAY_NEW_SHIPPING_gte: int | None = None, deltaLast_EBAY_USED_SHIPPING_lte: int | None = None, deltaLast_EBAY_USED_SHIPPING_gte: int | None = None, deltaLast_LIGHTNING_DEAL_lte: int | None = None, deltaLast_LIGHTNING_DEAL_gte: int | None = None, deltaLast_LISTPRICE_lte: int | None = None, deltaLast_LISTPRICE_gte: int | None = None, deltaLast_NEW_lte: int | None = None, deltaLast_NEW_gte: int | None = None, deltaLast_NEW_FBA_lte: int | None = None, deltaLast_NEW_FBA_gte: int | None = None, deltaLast_NEW_FBM_SHIPPING_lte: int | None = None, deltaLast_NEW_FBM_SHIPPING_gte: int | None = None, deltaLast_PRIME_EXCL_lte: int | None = None, deltaLast_PRIME_EXCL_gte: int | None = None, deltaLast_RATING_lte: int | None = None, deltaLast_RATING_gte: int | None = None, deltaLast_REFURBISHED_lte: int | None = None, deltaLast_REFURBISHED_gte: int | None = None, deltaLast_REFURBISHED_SHIPPING_lte: int | None = None, deltaLast_REFURBISHED_SHIPPING_gte: int | None = None, deltaLast_RENT_lte: int | None = None, deltaLast_RENT_gte: int | None = None, deltaLast_SALES_lte: int | None = None, deltaLast_SALES_gte: int | None = None, deltaLast_TRADE_IN_lte: int | None = None, deltaLast_TRADE_IN_gte: int | None = None, deltaLast_USED_lte: int | None = None, deltaLast_USED_gte: int | None = None, deltaLast_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, deltaLast_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, deltaLast_USED_GOOD_SHIPPING_lte: int | None = None, deltaLast_USED_GOOD_SHIPPING_gte: int | None = None, deltaLast_USED_NEW_SHIPPING_lte: int | None = None, deltaLast_USED_NEW_SHIPPING_gte: int | None = None, deltaLast_USED_VERY_GOOD_SHIPPING_lte: int | None = None, deltaLast_USED_VERY_GOOD_SHIPPING_gte: int | None = None, deltaLast_WAREHOUSE_lte: int | None = None, deltaLast_WAREHOUSE_gte: int | None = None, deltaPercent1_AMAZON_lte: Any | None = None, deltaPercent1_AMAZON_gte: Any | None = None, deltaPercent1_BUY_BOX_SHIPPING_lte: Any | None = None, deltaPercent1_BUY_BOX_SHIPPING_gte: Any | None = None, deltaPercent1_BUY_BOX_USED_SHIPPING_lte: Any | None = None, deltaPercent1_BUY_BOX_USED_SHIPPING_gte: Any | None = None, deltaPercent1_COLLECTIBLE_lte: Any | None = None, deltaPercent1_COLLECTIBLE_gte: Any | None = None, deltaPercent1_COUNT_COLLECTIBLE_lte: Any | None = None, deltaPercent1_COUNT_COLLECTIBLE_gte: Any | None = None, deltaPercent1_COUNT_NEW_lte: Any | None = None, deltaPercent1_COUNT_NEW_gte: Any | None = None, deltaPercent1_COUNT_REFURBISHED_lte: Any | None = None, deltaPercent1_COUNT_REFURBISHED_gte: Any | None = None, deltaPercent1_COUNT_REVIEWS_lte: Any | None = None, deltaPercent1_COUNT_REVIEWS_gte: Any | None = None, deltaPercent1_COUNT_USED_lte: Any | None = None, deltaPercent1_COUNT_USED_gte: Any | None = None, deltaPercent1_EBAY_NEW_SHIPPING_lte: Any | None = None, deltaPercent1_EBAY_NEW_SHIPPING_gte: Any | None = None, deltaPercent1_EBAY_USED_SHIPPING_lte: Any | None = None, deltaPercent1_EBAY_USED_SHIPPING_gte: Any | None = None, deltaPercent1_LIGHTNING_DEAL_lte: Any | None = None, deltaPercent1_LIGHTNING_DEAL_gte: Any | None = None, deltaPercent1_LISTPRICE_lte: Any | None = None, deltaPercent1_LISTPRICE_gte: Any | None = None, deltaPercent1_NEW_lte: Any | None = None, deltaPercent1_NEW_gte: Any | None = None, deltaPercent1_NEW_FBA_lte: Any | None = None, deltaPercent1_NEW_FBA_gte: Any | None = None, deltaPercent1_NEW_FBM_SHIPPING_lte: Any | None = None, deltaPercent1_NEW_FBM_SHIPPING_gte: Any | None = None, deltaPercent1_PRIME_EXCL_lte: Any | None = None, deltaPercent1_PRIME_EXCL_gte: Any | None = None, deltaPercent1_RATING_lte: Any | None = None, deltaPercent1_RATING_gte: Any | None = None, deltaPercent1_REFURBISHED_lte: Any | None = None, deltaPercent1_REFURBISHED_gte: Any | None = None, deltaPercent1_REFURBISHED_SHIPPING_lte: Any | None = None, deltaPercent1_REFURBISHED_SHIPPING_gte: Any | None = None, deltaPercent1_RENT_lte: Any | None = None, deltaPercent1_RENT_gte: Any | None = None, deltaPercent1_SALES_lte: Any | None = None, deltaPercent1_SALES_gte: Any | None = None, deltaPercent1_TRADE_IN_lte: Any | None = None, deltaPercent1_TRADE_IN_gte: Any | None = None, deltaPercent1_USED_lte: Any | None = None, deltaPercent1_USED_gte: Any | None = None, deltaPercent1_USED_ACCEPTABLE_SHIPPING_lte: Any | None = None, deltaPercent1_USED_ACCEPTABLE_SHIPPING_gte: Any | None = None, deltaPercent1_USED_GOOD_SHIPPING_lte: Any | None = None, deltaPercent1_USED_GOOD_SHIPPING_gte: Any | None = None, deltaPercent1_USED_NEW_SHIPPING_lte: Any | None = None, deltaPercent1_USED_NEW_SHIPPING_gte: Any | None = None, deltaPercent1_USED_VERY_GOOD_SHIPPING_lte: Any | None = None, deltaPercent1_USED_VERY_GOOD_SHIPPING_gte: Any | None = None, deltaPercent1_WAREHOUSE_lte: Any | None = None, deltaPercent1_WAREHOUSE_gte: Any | None = None, deltaPercent30_AMAZON_lte: Any | None = None, deltaPercent30_AMAZON_gte: Any | None = None, deltaPercent30_BUY_BOX_SHIPPING_lte: Any | None = None, deltaPercent30_BUY_BOX_SHIPPING_gte: Any | None = None, deltaPercent30_BUY_BOX_USED_SHIPPING_lte: Any | None = None, deltaPercent30_BUY_BOX_USED_SHIPPING_gte: Any | None = None, deltaPercent30_COLLECTIBLE_lte: Any | None = None, deltaPercent30_COLLECTIBLE_gte: Any | None = None, deltaPercent30_COUNT_COLLECTIBLE_lte: Any | None = None, deltaPercent30_COUNT_COLLECTIBLE_gte: Any | None = None, deltaPercent30_COUNT_NEW_lte: Any | None = None, deltaPercent30_COUNT_NEW_gte: Any | None = None, deltaPercent30_COUNT_REFURBISHED_lte: Any | None = None, deltaPercent30_COUNT_REFURBISHED_gte: Any | None = None, deltaPercent30_COUNT_REVIEWS_lte: Any | None = None, deltaPercent30_COUNT_REVIEWS_gte: Any | None = None, deltaPercent30_COUNT_USED_lte: Any | None = None, deltaPercent30_COUNT_USED_gte: Any | None = None, deltaPercent30_EBAY_NEW_SHIPPING_lte: Any | None = None, deltaPercent30_EBAY_NEW_SHIPPING_gte: Any | None = None, deltaPercent30_EBAY_USED_SHIPPING_lte: Any | None = None, deltaPercent30_EBAY_USED_SHIPPING_gte: Any | None = None, deltaPercent30_LIGHTNING_DEAL_lte: Any | None = None, deltaPercent30_LIGHTNING_DEAL_gte: Any | None = None, deltaPercent30_LISTPRICE_lte: Any | None = None, deltaPercent30_LISTPRICE_gte: Any | None = None, deltaPercent30_NEW_lte: Any | None = None, deltaPercent30_NEW_gte: Any | None = None, deltaPercent30_NEW_FBA_lte: Any | None = None, deltaPercent30_NEW_FBA_gte: Any | None = None, deltaPercent30_NEW_FBM_SHIPPING_lte: Any | None = None, deltaPercent30_NEW_FBM_SHIPPING_gte: Any | None = None, deltaPercent30_PRIME_EXCL_lte: Any | None = None, deltaPercent30_PRIME_EXCL_gte: Any | None = None, deltaPercent30_RATING_lte: Any | None = None, deltaPercent30_RATING_gte: Any | None = None, deltaPercent30_REFURBISHED_lte: Any | None = None, deltaPercent30_REFURBISHED_gte: Any | None = None, deltaPercent30_REFURBISHED_SHIPPING_lte: Any | None = None, deltaPercent30_REFURBISHED_SHIPPING_gte: Any | None = None, deltaPercent30_RENT_lte: Any | None = None, deltaPercent30_RENT_gte: Any | None = None, deltaPercent30_SALES_lte: Any | None = None, deltaPercent30_SALES_gte: Any | None = None, deltaPercent30_TRADE_IN_lte: Any | None = None, deltaPercent30_TRADE_IN_gte: Any | None = None, deltaPercent30_USED_lte: Any | None = None, deltaPercent30_USED_gte: Any | None = None, deltaPercent30_USED_ACCEPTABLE_SHIPPING_lte: Any | None = None, deltaPercent30_USED_ACCEPTABLE_SHIPPING_gte: Any | None = None, deltaPercent30_USED_GOOD_SHIPPING_lte: Any | None = None, deltaPercent30_USED_GOOD_SHIPPING_gte: Any | None = None, deltaPercent30_USED_NEW_SHIPPING_lte: Any | None = None, deltaPercent30_USED_NEW_SHIPPING_gte: Any | None = None, deltaPercent30_USED_VERY_GOOD_SHIPPING_lte: Any | None = None, deltaPercent30_USED_VERY_GOOD_SHIPPING_gte: Any | None = None, deltaPercent30_WAREHOUSE_lte: Any | None = None, deltaPercent30_WAREHOUSE_gte: Any | None = None, deltaPercent7_AMAZON_lte: Any | None = None, deltaPercent7_AMAZON_gte: Any | None = None, deltaPercent7_BUY_BOX_SHIPPING_lte: Any | None = None, deltaPercent7_BUY_BOX_SHIPPING_gte: Any | None = None, deltaPercent7_BUY_BOX_USED_SHIPPING_lte: Any | None = None, deltaPercent7_BUY_BOX_USED_SHIPPING_gte: Any | None = None, deltaPercent7_COLLECTIBLE_lte: Any | None = None, deltaPercent7_COLLECTIBLE_gte: Any | None = None, deltaPercent7_COUNT_COLLECTIBLE_lte: Any | None = None, deltaPercent7_COUNT_COLLECTIBLE_gte: Any | None = None, deltaPercent7_COUNT_NEW_lte: Any | None = None, deltaPercent7_COUNT_NEW_gte: Any | None = None, deltaPercent7_COUNT_REFURBISHED_lte: Any | None = None, deltaPercent7_COUNT_REFURBISHED_gte: Any | None = None, deltaPercent7_COUNT_REVIEWS_lte: Any | None = None, deltaPercent7_COUNT_REVIEWS_gte: Any | None = None, deltaPercent7_COUNT_USED_lte: Any | None = None, deltaPercent7_COUNT_USED_gte: Any | None = None, deltaPercent7_EBAY_NEW_SHIPPING_lte: Any | None = None, deltaPercent7_EBAY_NEW_SHIPPING_gte: Any | None = None, deltaPercent7_EBAY_USED_SHIPPING_lte: Any | None = None, deltaPercent7_EBAY_USED_SHIPPING_gte: Any | None = None, deltaPercent7_LIGHTNING_DEAL_lte: Any | None = None, deltaPercent7_LIGHTNING_DEAL_gte: Any | None = None, deltaPercent7_LISTPRICE_lte: Any | None = None, deltaPercent7_LISTPRICE_gte: Any | None = None, deltaPercent7_NEW_lte: Any | None = None, deltaPercent7_NEW_gte: Any | None = None, deltaPercent7_NEW_FBA_lte: Any | None = None, deltaPercent7_NEW_FBA_gte: Any | None = None, deltaPercent7_NEW_FBM_SHIPPING_lte: Any | None = None, deltaPercent7_NEW_FBM_SHIPPING_gte: Any | None = None, deltaPercent7_PRIME_EXCL_lte: Any | None = None, deltaPercent7_PRIME_EXCL_gte: Any | None = None, deltaPercent7_RATING_lte: Any | None = None, deltaPercent7_RATING_gte: Any | None = None, deltaPercent7_REFURBISHED_lte: Any | None = None, deltaPercent7_REFURBISHED_gte: Any | None = None, deltaPercent7_REFURBISHED_SHIPPING_lte: Any | None = None, deltaPercent7_REFURBISHED_SHIPPING_gte: Any | None = None, deltaPercent7_RENT_lte: Any | None = None, deltaPercent7_RENT_gte: Any | None = None, deltaPercent7_SALES_lte: Any | None = None, deltaPercent7_SALES_gte: Any | None = None, deltaPercent7_TRADE_IN_lte: Any | None = None, deltaPercent7_TRADE_IN_gte: Any | None = None, deltaPercent7_USED_lte: Any | None = None, deltaPercent7_USED_gte: Any | None = None, deltaPercent7_USED_ACCEPTABLE_SHIPPING_lte: Any | None = None, deltaPercent7_USED_ACCEPTABLE_SHIPPING_gte: Any | None = None, deltaPercent7_USED_GOOD_SHIPPING_lte: Any | None = None, deltaPercent7_USED_GOOD_SHIPPING_gte: Any | None = None, deltaPercent7_USED_NEW_SHIPPING_lte: Any | None = None, deltaPercent7_USED_NEW_SHIPPING_gte: Any | None = None, deltaPercent7_USED_VERY_GOOD_SHIPPING_lte: Any | None = None, deltaPercent7_USED_VERY_GOOD_SHIPPING_gte: Any | None = None, deltaPercent7_WAREHOUSE_lte: Any | None = None, deltaPercent7_WAREHOUSE_gte: Any | None = None, deltaPercent90_AMAZON_lte: Any | None = None, deltaPercent90_AMAZON_gte: Any | None = None, deltaPercent90_BUY_BOX_SHIPPING_lte: Any | None = None, deltaPercent90_BUY_BOX_SHIPPING_gte: Any | None = None, deltaPercent90_BUY_BOX_USED_SHIPPING_lte: Any | None = None, deltaPercent90_BUY_BOX_USED_SHIPPING_gte: Any | None = None, deltaPercent90_COLLECTIBLE_lte: Any | None = None, deltaPercent90_COLLECTIBLE_gte: Any | None = None, deltaPercent90_COUNT_COLLECTIBLE_lte: Any | None = None, deltaPercent90_COUNT_COLLECTIBLE_gte: Any | None = None, deltaPercent90_COUNT_NEW_lte: Any | None = None, deltaPercent90_COUNT_NEW_gte: Any | None = None, deltaPercent90_COUNT_REFURBISHED_lte: Any | None = None, deltaPercent90_COUNT_REFURBISHED_gte: Any | None = None, deltaPercent90_COUNT_REVIEWS_lte: Any | None = None, deltaPercent90_COUNT_REVIEWS_gte: Any | None = None, deltaPercent90_COUNT_USED_lte: Any | None = None, deltaPercent90_COUNT_USED_gte: Any | None = None, deltaPercent90_EBAY_NEW_SHIPPING_lte: Any | None = None, deltaPercent90_EBAY_NEW_SHIPPING_gte: Any | None = None, deltaPercent90_EBAY_USED_SHIPPING_lte: Any | None = None, deltaPercent90_EBAY_USED_SHIPPING_gte: Any | None = None, deltaPercent90_LIGHTNING_DEAL_lte: Any | None = None, deltaPercent90_LIGHTNING_DEAL_gte: Any | None = None, deltaPercent90_LISTPRICE_lte: Any | None = None, deltaPercent90_LISTPRICE_gte: Any | None = None, deltaPercent90_NEW_lte: Any | None = None, deltaPercent90_NEW_gte: Any | None = None, deltaPercent90_NEW_FBA_lte: Any | None = None, deltaPercent90_NEW_FBA_gte: Any | None = None, deltaPercent90_NEW_FBM_SHIPPING_lte: Any | None = None, deltaPercent90_NEW_FBM_SHIPPING_gte: Any | None = None, deltaPercent90_PRIME_EXCL_lte: Any | None = None, deltaPercent90_PRIME_EXCL_gte: Any | None = None, deltaPercent90_RATING_lte: Any | None = None, deltaPercent90_RATING_gte: Any | None = None, deltaPercent90_REFURBISHED_lte: Any | None = None, deltaPercent90_REFURBISHED_gte: Any | None = None, deltaPercent90_REFURBISHED_SHIPPING_lte: Any | None = None, deltaPercent90_REFURBISHED_SHIPPING_gte: Any | None = None, deltaPercent90_RENT_lte: Any | None = None, deltaPercent90_RENT_gte: Any | None = None, deltaPercent90_SALES_lte: Any | None = None, deltaPercent90_SALES_gte: Any | None = None, deltaPercent90_TRADE_IN_lte: Any | None = None, deltaPercent90_TRADE_IN_gte: Any | None = None, deltaPercent90_USED_lte: Any | None = None, deltaPercent90_USED_gte: Any | None = None, deltaPercent90_USED_ACCEPTABLE_SHIPPING_lte: Any | None = None, deltaPercent90_USED_ACCEPTABLE_SHIPPING_gte: Any | None = None, deltaPercent90_USED_GOOD_SHIPPING_lte: Any | None = None, deltaPercent90_USED_GOOD_SHIPPING_gte: Any | None = None, deltaPercent90_USED_NEW_SHIPPING_lte: Any | None = None, deltaPercent90_USED_NEW_SHIPPING_gte: Any | None = None, deltaPercent90_USED_VERY_GOOD_SHIPPING_lte: Any | None = None, deltaPercent90_USED_VERY_GOOD_SHIPPING_gte: Any | None = None, deltaPercent90_WAREHOUSE_lte: Any | None = None, deltaPercent90_WAREHOUSE_gte: Any | None = None, edition: list[str] | str | None = None, fbaFees_lte: int | None = None, fbaFees_gte: int | None = None, format: list[str] | str | None = None, genre: list[str] | str | None = None, hasParentASIN: bool | None = None, hasReviews: bool | None = None, isAdultProduct: bool | None = None, isEligibleForSuperSaverShipping: bool | None = None, isEligibleForTradeIn: bool | None = None, isHighestOffer: bool | None = None, isLowestOffer: bool | None = None, isLowest_AMAZON: bool | None = None, isLowest_BUY_BOX_SHIPPING: bool | None = None, isLowest_BUY_BOX_USED_SHIPPING: bool | None = None, isLowest_COLLECTIBLE: bool | None = None, isLowest_COUNT_COLLECTIBLE: bool | None = None, isLowest_COUNT_NEW: bool | None = None, isLowest_COUNT_REFURBISHED: bool | None = None, isLowest_COUNT_REVIEWS: bool | None = None, isLowest_COUNT_USED: bool | None = None, isLowest_EBAY_NEW_SHIPPING: bool | None = None, isLowest_EBAY_USED_SHIPPING: bool | None = None, isLowest_LIGHTNING_DEAL: bool | None = None, isLowest_LISTPRICE: bool | None = None, isLowest_NEW: bool | None = None, isLowest_NEW_FBA: bool | None = None, isLowest_NEW_FBM_SHIPPING: bool | None = None, isLowest_PRIME_EXCL: bool | None = None, isLowest_RATING: bool | None = None, isLowest_REFURBISHED: bool | None = None, isLowest_REFURBISHED_SHIPPING: bool | None = None, isLowest_RENT: bool | None = None, isLowest_SALES: bool | None = None, isLowest_TRADE_IN: bool | None = None, isLowest_USED: bool | None = None, isLowest_USED_ACCEPTABLE_SHIPPING: bool | None = None, isLowest_USED_GOOD_SHIPPING: bool | None = None, isLowest_USED_NEW_SHIPPING: bool | None = None, isLowest_USED_VERY_GOOD_SHIPPING: bool | None = None, isLowest_WAREHOUSE: bool | None = None, isPrimeExclusive: bool | None = None, isSNS: bool | None = None, itemDimension_lte: int | None = None, itemDimension_gte: int | None = None, itemHeight_lte: int | None = None, itemHeight_gte: int | None = None, itemLength_lte: int | None = None, itemLength_gte: int | None = None, itemWeight_lte: int | None = None, itemWeight_gte: int | None = None, itemWidth_lte: int | None = None, itemWidth_gte: int | None = None, label: list[str] | str | None = None, languages: list[str] | str | None = None, lastOffersUpdate_lte: int | None = None, lastOffersUpdate_gte: int | None = None, lastPriceChange_lte: int | None = None, lastPriceChange_gte: int | None = None, lastPriceChange_AMAZON_lte: int | None = None, lastPriceChange_AMAZON_gte: int | None = None, lastPriceChange_NEW_lte: int | None = None, lastPriceChange_NEW_gte: int | None = None, lastPriceChange_USED_lte: int | None = None, lastPriceChange_USED_gte: int | None = None, lastPriceChange_SALES_lte: int | None = None, lastPriceChange_SALES_gte: int | None = None, lastPriceChange_LISTPRICE_lte: int | None = None, lastPriceChange_LISTPRICE_gte: int | None = None, lastPriceChange_COLLECTIBLE_lte: int | None = None, lastPriceChange_COLLECTIBLE_gte: int | None = None, lastPriceChange_REFURBISHED_lte: int | None = None, lastPriceChange_REFURBISHED_gte: int | None = None, lastPriceChange_NEW_FBM_SHIPPING_lte: int | None = None, lastPriceChange_NEW_FBM_SHIPPING_gte: int | None = None, lastPriceChange_LIGHTNING_DEAL_lte: int | None = None, lastPriceChange_LIGHTNING_DEAL_gte: int | None = None, lastPriceChange_WAREHOUSE_lte: int | None = None, lastPriceChange_WAREHOUSE_gte: int | None = None, lastPriceChange_NEW_FBA_lte: int | None = None, lastPriceChange_NEW_FBA_gte: int | None = None, lastPriceChange_COUNT_NEW_lte: int | None = None, lastPriceChange_COUNT_NEW_gte: int | None = None, lastPriceChange_COUNT_USED_lte: int | None = None, lastPriceChange_COUNT_USED_gte: int | None = None, lastPriceChange_COUNT_REFURBISHED_lte: int | None = None, lastPriceChange_COUNT_REFURBISHED_gte: int | None = None, lastPriceChange_COUNT_COLLECTIBLE_lte: int | None = None, lastPriceChange_COUNT_COLLECTIBLE_gte: int | None = None, lastPriceChange_RATING_lte: int | None = None, lastPriceChange_RATING_gte: int | None = None, lastPriceChange_COUNT_REVIEWS_lte: int | None = None, lastPriceChange_COUNT_REVIEWS_gte: int | None = None, lastPriceChange_BUY_BOX_SHIPPING_lte: int | None = None, lastPriceChange_BUY_BOX_SHIPPING_gte: int | None = None, lastPriceChange_USED_NEW_SHIPPING_lte: int | None = None, lastPriceChange_USED_NEW_SHIPPING_gte: int | None = None, lastPriceChange_USED_VERY_GOOD_SHIPPING_lte: int | None = None, lastPriceChange_USED_VERY_GOOD_SHIPPING_gte: int | None = None, lastPriceChange_USED_GOOD_SHIPPING_lte: int | None = None, lastPriceChange_USED_GOOD_SHIPPING_gte: int | None = None, lastPriceChange_USED_ACCEPTABLE_SHIPPING_lte: int | None = None, lastPriceChange_USED_ACCEPTABLE_SHIPPING_gte: int | None = None, lastPriceChange_REFURBISHED_SHIPPING_lte: int | None = None, lastPriceChange_REFURBISHED_SHIPPING_gte: int | None = None, lastPriceChange_EBAY_NEW_SHIPPING_lte: int | None = None, lastPriceChange_EBAY_NEW_SHIPPING_gte: int | None = None, lastPriceChange_EBAY_USED_SHIPPING_lte: int | None = None, lastPriceChange_EBAY_USED_SHIPPING_gte: int | None = None, lastPriceChange_TRADE_IN_lte: int | None = None, lastPriceChange_TRADE_IN_gte: int | None = None, lastPriceChange_RENT_lte: int | None = None, lastPriceChange_RENT_gte: int | None = None, lastPriceChange_BUY_BOX_USED_SHIPPING_lte: int | None = None, lastPriceChange_BUY_BOX_USED_SHIPPING_gte: int | None = None, lastPriceChange_PRIME_EXCL_lte: int | None = None, lastPriceChange_PRIME_EXCL_gte: int | None = None, lastRatingUpdate_lte: int | None = None, lastRatingUpdate_gte: int | None = None, lastUpdate_lte: int | None = None, lastUpdate_gte: int | None = None, lightningEnd_lte: int | None = None, lightningEnd_gte: int | None = None, lightningStart_lte: int | None = None, lightningStart_gte: int | None = None, listedSince_lte: int | None = None, listedSince_gte: int | None = None, manufacturer: list[str] | str | None = None, model: list[str] | str | None = None, newPriceIsMAP: bool | None = None, nextUpdate_lte: int | None = None, nextUpdate_gte: int | None = None, numberOfItems_lte: int | None = None, numberOfItems_gte: int | None = None, numberOfPages_lte: int | None = None, numberOfPages_gte: int | None = None, numberOfTrackings_lte: int | None = None, numberOfTrackings_gte: int | None = None, offerCountFBA_lte: int | None = None, offerCountFBA_gte: int | None = None, offerCountFBM_lte: int | None = None, offerCountFBM_gte: int | None = None, outOfStockPercentage90_BB_lte: int | None = None, outOfStockPercentage90_BB_gte: int | None = None, outOfStockPercentage90_BB_USED_lte: int | None = None, outOfStockPercentage90_BB_USED_gte: int | None = None, outOfStockPercentage90_NEW_lte: int | None = None, outOfStockPercentage90_NEW_gte: int | None = None, outOfStockPercentage90_USED_lte: int | None = None, outOfStockPercentage90_USED_gte: int | None = None, outOfStockPercentageInInterval_lte: int | None = None, outOfStockPercentageInInterval_gte: int | None = None, packageDimension_lte: int | None = None, packageDimension_gte: int | None = None, packageHeight_lte: int | None = None, packageHeight_gte: int | None = None, packageLength_lte: int | None = None, packageLength_gte: int | None = None, packageQuantity_lte: int | None = None, packageQuantity_gte: int | None = None, packageWeight_lte: int | None = None, packageWeight_gte: int | None = None, packageWidth_lte: int | None = None, packageWidth_gte: int | None = None, partNumber: list[str] | str | None = None, platform: list[str] | str | None = None, productGroup: list[str] | str | None = None, productType: list[int] | None = None, publicationDate_lte: int | None = None, publicationDate_gte: int | None = None, publisher: list[str] | str | None = None, releaseDate_lte: int | None = None, releaseDate_gte: int | None = None, rootCategory: list[str] | str | None = None, salesRankDrops180_lte: int | None = None, salesRankDrops180_gte: int | None = None, salesRankDrops30_lte: int | None = None, salesRankDrops30_gte: int | None = None, salesRankDrops365_lte: int | None = None, salesRankDrops365_gte: int | None = None, salesRankDrops90_lte: int | None = None, salesRankDrops90_gte: int | None = None, salesRankReference: int | None = None, salesRankTopPct_lte: int | None = None, salesRankTopPct_gte: int | None = None, sellerIds: list[str] | str | None = None, sellerIdsLowestFBA: list[str] | str | None = None, sellerIdsLowestFBM: list[str] | str | None = None, size: list[str] | str | None = None, studio: list[str] | str | None = None, title: str | None = None, title_flag: str | None = None, totalOfferCount_lte: int | None = None, totalOfferCount_gte: int | None = None, trackingSince_lte: int | None = None, trackingSince_gte: int | None = None, monthlySold_lte: int | None = None, monthlySold_gte: int | None = None, buyBoxIsPreorder: bool | None = None, buyBoxIsBackorder: bool | None = None, buyBoxIsPrimeExclusive: bool | None = None, buyBoxIsPrimeEligible: bool | None = None, type: list[str] | str | None = None, warehouseCondition: list[int] | None = None, singleVariation: bool | None = None, outOfStockPercentage90_lte: int | None = None, outOfStockPercentage90_gte: int | None = None, variationCount_lte: int | None = None, variationCount_gte: int | None = None, imageCount_lte: int | None = None, imageCount_gte: int | None = None, buyBoxStatsAmazon30_lte: int | None = None, buyBoxStatsAmazon30_gte: int | None = None, buyBoxStatsAmazon90_lte: int | None = None, buyBoxStatsAmazon90_gte: int | None = None, buyBoxStatsAmazon180_lte: int | None = None, buyBoxStatsAmazon180_gte: int | None = None, buyBoxStatsAmazon365_lte: int | None = None, buyBoxStatsAmazon365_gte: int | None = None, buyBoxStatsTopSeller30_lte: int | None = None, buyBoxStatsTopSeller30_gte: int | None = None, buyBoxStatsTopSeller90_lte: int | None = None, buyBoxStatsTopSeller90_gte: int | None = None, buyBoxStatsTopSeller180_lte: int | None = None, buyBoxStatsTopSeller180_gte: int | None = None, buyBoxStatsTopSeller365_lte: int | None = None, buyBoxStatsTopSeller365_gte: int | None = None, buyBoxStatsSellerCount30_lte: int | None = None, buyBoxStatsSellerCount30_gte: int | None = None, buyBoxStatsSellerCount90_lte: int | None = None, buyBoxStatsSellerCount90_gte: int | None = None, buyBoxStatsSellerCount180_lte: int | None = None, buyBoxStatsSellerCount180_gte: int | None = None, buyBoxStatsSellerCount365_lte: int | None = None, buyBoxStatsSellerCount365_gte: int | None = None, isHazMat: bool | None = None, isHeatSensitive: bool | None = None, buyBoxStandardDeviation30_lte: int | None = None, buyBoxStandardDeviation30_gte: int | None = None, buyBoxStandardDeviation90_lte: int | None = None, buyBoxStandardDeviation90_gte: int | None = None, buyBoxStandardDeviation365_lte: int | None = None, buyBoxStandardDeviation365_gte: int | None = None, flipability30_lte: int | None = None, flipability30_gte: int | None = None, flipability90_lte: int | None = None, flipability90_gte: int | None = None, flipability365_lte: int | None = None, flipability365_gte: int | None = None, itemTypeKeyword: list[str] | str | None = None, targetAudienceKeyword: list[str] | str | None = None, itemForm: list[str] | str | None = None, scent: str | None = None, unitType: str | None = None, unitValue_lte: float | None = None, unitValue_gte: float | None = None, pattern: str | None = None, batteriesRequired: bool | None = None, batteriesIncluded: bool | None = None, style: str | None = None, material: str | None = None, lastBusinessDiscountUpdate_lte: int | None = None, lastBusinessDiscountUpdate_gte: int | None = None, businessDiscount_lte: int | None = None, businessDiscount_gte: int | None = None, activeIngredients: list[str] | str | None = None, specialIngredients: list[str] | str | None = None, isMerchOnDemand: bool | None = None, hasMainVideo: bool | None = None, hasAPlus: bool | None = None, hasAPlusFromManufacturer: bool | None = None, videoCount_lte: int | None = None, videoCount_gte: int | None = None, brandStoreName: list[str] | str | None = None, brandStoreUrlName: list[str] | str | None = None, returnRate: list[int] | None = None, deltaPercent90_monthlySold_lte: int | None = None, deltaPercent90_monthlySold_gte: int | None = None, outOfStockCountAmazon30_lte: int | None = None, outOfStockCountAmazon30_gte: int | None = None, outOfStockCountAmazon90_lte: int | None = None, outOfStockCountAmazon90_gte: int | None = None, variationReviewCount_lte: int | None = None, variationReviewCount_gte: int | None = None, variationRatingCount_lte: int | None = None, variationRatingCount_gte: int | None = None, websiteDisplayGroupName: list[str] | str | None = None, websiteDisplayGroup: list[str] | str | None = None, availabilityAmazonMinDelayInDays_lte: int | None = None, availabilityAmazonMinDelayInDays_gte: int | None = None, blackList: list[int] | None = None, isDeal: bool | None = None, launchpad: bool | None = None, historicalSellerIds: list[str] | str | None = None, buyBoxShippingCountry: list[str] | str | None = None, sellerIdsFBA: list[str] | str | None = None, sellerIdsFBM: list[str] | str | None = None, buyBoxStatsTopSellerId30: list[str] | str | None = None, buyBoxStatsTopSellerId90: list[str] | str | None = None, buyBoxStatsTopSellerId180: list[str] | str | None = None, buyBoxStatsTopSellerId365: list[str] | str | None = None, buyBoxEligibleOfferCountsNewFBA_lte: Any | None = None, buyBoxEligibleOfferCountsNewFBA_gte: Any | None = None, buyBoxEligibleOfferCountsNewFBM_lte: Any | None = None, buyBoxEligibleOfferCountsNewFBM_gte: Any | None = None, buyBoxEligibleOfferCountsUsedFBA_lte: Any | None = None, buyBoxEligibleOfferCountsUsedFBA_gte: Any | None = None, buyBoxEligibleOfferCountsUsedFBM_lte: Any | None = None, buyBoxEligibleOfferCountsUsedFBM_gte: Any | None = None, srAvg000_gte: int | None = None, srAvg001_gte: int | None = None, srAvg002_gte: int | None = None, srAvg003_gte: int | None = None, srAvg004_gte: int | None = None, srAvg005_gte: int | None = None, srAvg006_gte: int | None = None, srAvg007_gte: int | None = None, srAvg008_gte: int | None = None, srAvg009_gte: int | None = None, srAvg010_gte: int | None = None, srAvg011_gte: int | None = None, srAvg100_gte: int | None = None, srAvg101_gte: int | None = None, srAvg102_gte: int | None = None, srAvg103_gte: int | None = None, srAvg104_gte: int | None = None, srAvg105_gte: int | None = None, srAvg106_gte: int | None = None, srAvg107_gte: int | None = None, srAvg108_gte: int | None = None, srAvg109_gte: int | None = None, srAvg110_gte: int | None = None, srAvg111_gte: int | None = None, srAvg200_gte: int | None = None, srAvg201_gte: int | None = None, srAvg202_gte: int | None = None, srAvg203_gte: int | None = None, srAvg204_gte: int | None = None, srAvg205_gte: int | None = None, srAvg206_gte: int | None = None, srAvg207_gte: int | None = None, srAvg208_gte: int | None = None, srAvg209_gte: int | None = None, srAvg210_gte: int | None = None, srAvg211_gte: int | None = None, srAvg000_lte: int | None = None, srAvg001_lte: int | None = None, srAvg002_lte: int | None = None, srAvg003_lte: int | None = None, srAvg004_lte: int | None = None, srAvg005_lte: int | None = None, srAvg006_lte: int | None = None, srAvg007_lte: int | None = None, srAvg008_lte: int | None = None, srAvg009_lte: int | None = None, srAvg010_lte: int | None = None, srAvg011_lte: int | None = None, srAvg100_lte: int | None = None, srAvg101_lte: int | None = None, srAvg102_lte: int | None = None, srAvg103_lte: int | None = None, srAvg104_lte: int | None = None, srAvg105_lte: int | None = None, srAvg106_lte: int | None = None, srAvg107_lte: int | None = None, srAvg108_lte: int | None = None, srAvg109_lte: int | None = None, srAvg110_lte: int | None = None, srAvg111_lte: int | None = None, srAvg200_lte: int | None = None, srAvg201_lte: int | None = None, srAvg202_lte: int | None = None, srAvg203_lte: int | None = None, srAvg204_lte: int | None = None, srAvg205_lte: int | None = None, srAvg206_lte: int | None = None, srAvg207_lte: int | None = None, srAvg208_lte: int | None = None, srAvg209_lte: int | None = None, srAvg210_lte: int | None = None, srAvg211_lte: int | None = None, minMatch: dict[str, int] | None = None, sort: list[list[str]] | None = None, perPage: int = 50, page: int = 0)#
Product request parameters.
See: keepacom/api_backend
- Attributes:
model_extraGet extra fields set during validation.
model_fields_setReturns the set of fields that have been explicitly set on this model instance.
Methods
copy(*[, include, exclude, update, deep])Returns a copy of the model.
model_construct([_fields_set])Creates a new instance of the Model class with validated data.
model_copy(*[, update, deep])!!! abstract "Usage Documentation"
model_dump(*[, mode, include, exclude, ...])!!! abstract "Usage Documentation"
model_dump_json(*[, indent, ensure_ascii, ...])!!! abstract "Usage Documentation"
model_json_schema(by_alias, ref_template, ...)Generates a JSON schema for a model class.
model_parametrized_name(params)Compute the class name for parametrizations of generic classes.
model_post_init(context, /)Override this method to perform additional initialization after __init__ and model_construct.
model_rebuild(*[, force, raise_errors, ...])Try to rebuild the pydantic-core schema for the model.
model_validate(obj, *[, strict, extra, ...])Validate a pydantic model instance.
model_validate_json(json_data, *[, strict, ...])!!! abstract "Usage Documentation"
model_validate_strings(obj, *[, strict, ...])Validate the given object with string data against the Pydantic model.
construct
dict
from_orm
json
parse_file
parse_obj
parse_raw
schema
schema_json
update_forward_refs
validate
Examples
Use attributes:
>>> import keepa >>> product_params = keepa.ProductParams() >>> product_params.author = "J. R. R. Tolkien"
Use keywords:
>>> product_params = keepa.ProductParams(author="J. R. R. Tolkien")
Use within
keepa.Keepa.product_finder():>>> import keepa >>> api = keepa.Keepa("<ENTER_ACTUAL_KEY_HERE>") >>> product_params = keepa.ProductParams(author="J. R. R. Tolkien") >>> asins = api.product_finder(product_parms, n_products=100)