changedInput schema / properties / brands / description
Previous value: -"Brand filter."New value: +"Comma-separated brand ids, e.g. 46655 for Samsung on US. Take them from brand_id on any deals row or from available_filters.brands (the brands present in the current result). Names resolve only when this marketplace has already shown that brand; for a brand by name use /search with brand=<name> and today_deals=true instead."
changedInput schema / properties / categories / description
Previous value: -"Category filter."New value: +"Department to restrict to: its id from available_filters.categories, or its name as Amazon shows it for that marketplace (case-insensitive; a unique fragment such as \"electronics\" works). US departments: Amazon Devices & Accessories, Appliances, Arts Crafts & Sewing, Audible Books & Originals, Automotive, Baby Products, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Electronics, Everything Else, Grocery & Gourmet Food, Handmade Products, Health & Household, Home & Kitchen, Industrial & Scientific, Kindle Store, Movies & TV, Musical Instruments, Office Products, Patio Lawn & Garden, Pet Supplies, Software, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games. Other marketplaces use their own localised names -- read them from available_filters.categories of any deals answer for that geo. An unknown name is a free 400 listing the valid names."
changedInput schema / properties / compact / description
Previous value: -"Return light rows: identity, price, rating, badges and one delivery_date, dropping the long delivery prose that repeats itself across three fields. false returns every field the REST API sends (roughly 3x the size)."New value: +"Return light rows: identity, prices, discount, badge, end time, links, brand_id and department_ids, dropping the image arrays. false returns every field the REST API sends."
removedInput schema / properties / discount_range
Removed value: -{
- "anyOf": [
- {
- "enum": [
- "1",
- "2",
- "3",
- "4",
- "ALL"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "default": null,
- "description": "Discount band bucket 1-4, or ALL.",
- "title": "Discount Range"
-}
changedInput schema / properties / limit / description
Previous value: -"How many deals to return from this page (0 = all of them). A full page is up to 48 rows and about 54 KB, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims."New value: +"How many deals to return from this page (0 = all of them). A full page is 30 rows and roughly 35 KB with every field, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims."
addedInput schema / properties / max_discount
Added value: +{
+ "anyOf": [
+ {
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null,
+ "description": "Largest discount percentage to return.",
+ "title": "Max Discount"
+}
addedInput schema / properties / max_price
Added value: +{
+ "anyOf": [
+ {
+ "minimum": 0,
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null,
+ "description": "Highest deal price to return, in the marketplace currency.",
+ "title": "Max Price"
+}
addedInput schema / properties / min_discount
Added value: +{
+ "anyOf": [
+ {
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null,
+ "description": "Smallest discount percentage to return, e.g. 50 for half price or better.",
+ "title": "Min Discount"
+}
addedInput schema / properties / min_price
Added value: +{
+ "anyOf": [
+ {
+ "minimum": 0,
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null,
+ "description": "Lowest deal price to return, in the marketplace currency. Applied to the fetched rows; see notes.",
+ "title": "Min Price"
+}
changedInput schema / properties / min_product_star_rating / anyOf
Previous value: -[
- {
- "enum": [
- "1",
- "2",
- "3",
- "4",
- "ALL"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
-]New value: +[
+ {
+ "enum": [
+ "4",
+ "ALL"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+]
changedInput schema / properties / min_product_star_rating / description
Previous value: -"Minimum star rating. Only 1, 2, 3, 4 or ALL are accepted - 5 is rejected with 400."New value: +"Amazon's deals feed offers one rating cut-off: 4 = four stars and up. ALL or omitted = no cut-off. Other values are rejected with a free 400."
changedInput schema / properties / offset / description
Previous value: -"Pagination offset, non-negative."New value: +"Row to start at. A page is 30 rows; pass the previous answer's next_offset for the next page."
removedInput schema / properties / price_range
Removed value: -{
- "anyOf": [
- {
- "enum": [
- "1",
- "2",
- "3",
- "4",
- "5",
- "ALL"
- ],
- "type": "string"
- },
- {
- "type": "null"
- }
- ],
- "default": null,
- "description": "Price band bucket 1-5, or ALL.",
- "title": "Price Range"
-}
changedInput schema / properties / prime_early_access / description
Previous value: -"Restrict to Prime early access deals."New value: +"Only Prime Early Access deals. A marketplace lists the programs it is running under available_filters.prime_programs; when Early Access is not running the answer is empty with a hint saying so."
addedInput schema / properties / prime_exclusive
Added value: +{
+ "default": false,
+ "description": "Only deals in Amazon's Prime Exclusive program.",
+ "title": "Prime Exclusive",
+ "type": "boolean"
+}