{ "openapi": "3.0.1", "info": { "title": "DealSeek Scraper - Amazon Deals & Promo Codes", "description": "Scrape DealSeek in 8 countries: Amazon, Walmart and eBay deals with promo codes, coupons, final prices and price history. 20+ filters: discount, rating, brand, seller, category, deal type. No 5,000-result cap, only-new mode. Excel, CSV or API.", "version": "0.1", "x-build-id": "TMOUdgZuHHZIjqsbD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pshivam~dealseek-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pshivam-dealseek-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/pshivam~dealseek-scraper/runs": { "post": { "operationId": "runs-sync-pshivam-dealseek-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/pshivam~dealseek-scraper/run-sync": { "post": { "operationId": "run-sync-pshivam-dealseek-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "countries": { "title": "Countries", "type": "array", "description": "DealSeek countries to scrape, in one run. Empty = United States. Prices are in each country's currency, and links go to that country's Amazon.", "items": { "type": "string", "enum": [ "us", "uk", "ca", "de", "es", "fr", "it", "au" ], "enumTitles": [ "United States (USD)", "United Kingdom (GBP)", "Canada (CAD)", "Germany (EUR)", "Spain (EUR)", "France (EUR)", "Italy (EUR)", "Australia (AUD)" ] } }, "stores": { "title": "Stores", "type": "array", "description": "Which store's deals. Empty = Amazon. Walmart and eBay deals exist only in the United States.", "items": { "type": "string", "enum": [ "amazon", "walmart", "ebay" ], "enumTitles": [ "Amazon", "Walmart", "eBay" ] } }, "keywords": { "title": "Search keywords", "type": "array", "description": "What you'd type in DealSeek's search box, e.g. \"airpods\" or \"air fryer\". Each keyword is its own search. Empty = all deals. An Amazon product id (ASIN) works too.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Only these categories (Electronics, Home & Kitchen, ...), or the groups Tech and Home. Names differ by country, e.g. Fashion in the UK.", "items": { "type": "string", "enumSuggestedValues": [ "Tech", "Home", "Clothing, Shoes & Jewelry", "Home & Kitchen", "Tools & Home Improvement", "Automotive", "Sports & Outdoors", "Patio, Lawn & Garden", "Beauty & Personal Care", "Health & Household", "Electronics", "Toys & Games", "Pet Supplies", "Cell Phones & Accessories", "Office Products", "Industrial & Scientific", "Arts, Crafts & Sewing", "Baby Products", "Musical Instruments", "Appliances", "Grocery & Gourmet Food", "Video Games", "Digital Music", "Kitchen & Dining", "Medical Supplies & Equipment", "Power Tool Parts & Accessories", "Restaurant Appliances & Equipment", "Fashion", "Beauty", "Electronics & Photo", "Health & Personal Care", "Computers & Accessories", "DIY & Tools", "Garden", "Stationery & Office Supplies", "Lighting", "Business, Industry & Science", "Musical Instruments & DJ", "Grocery", "PC & Video Games", "DVD & Blu-ray", "Large Appliances", "Kitchen & Home Appliances", "Clothing, Shoes & Accessories", "Musical Instruments, Stage & Studio", "Baby", "Computer & Accessories", "Toys", "Computers", "Videogames", "Sports, Fitness & Outdoors", "Health, Household & Personal Care", "Home Improvement", "Stationery & Office Products" ] } }, "subcategories": { "title": "Subcategories", "type": "array", "description": "Only these subcategories, e.g. Exercise & Fitness or Bedding, written as DealSeek writes them.", "items": { "type": "string", "enumSuggestedValues": [ "Women", "Men", "Kitchen & Dining", "Home Décor Products", "Bedding", "Lighting & Ceiling Fans", "Replacement Parts", "Outdoor Décor", "Dogs", "Fan Shop", "Hardware", "Office & School Supplies", "Hair Care", "Novelty & More", "Health Care", "Sports", "Bath", "Accessories", "Seasonal Décor", "Hunting & Fishing", "Computers & Accessories", "Patio Furniture & Accessories", "Baby", "Boys", "Girls", "Power & Hand Tools", "Headphones, Earbuds & Accessories", "Skin Care", "Stationery & Gift Wrapping Supplies", "Tools & Accessories", "Cases, Holsters & Sleeves", "Cats", "Interior Accessories", "Sport Specific Clothing", "Camera & Photo", "Electrical", "Tools & Equipment", "Costumes & Accessories", "Furniture", "Gardening & Lawn Care", "Household Supplies", "Luggage & Travel Gear", "Motorcycle & Powersports", "Portable Audio & Video", "Shave & Hair Removal", "Wellness & Relaxation", "Exercise & Fitness", "Outdoor Power Tools", "Parts & Accessories", "Wall Art", "Beading & Jewelry Making", "Exterior Accessories", "Foot, Hand & Nail Care", "Games & Accessories", "Heating, Cooling & Air Quality", "Nursery", "Remote & App Controlled Vehicles & Parts", "Shoe, Jewelry & Watch Accessories", "Sports & Outdoor Play", "Vitamins, Minerals & Supplements", "Arts & Crafts", "Car & Vehicle Electronics", "Event & Party Supplies", "Learning & Education", "Makeup", "Oral Care", "Paint, Wall Treatments & Supplies", "Sports & Outdoor Recreation Accessories", "Tires & Wheels", "Food Service Equipment & Supplies", "Instrument Accessories", "Novelty & Gag Toys", "Outdoor Recreation", "Personal Care", "Safety & Security", "Storage & Organization", "Wearable Technology", "Building Toys", "Crafting", "Grills & Outdoor Cooking", "Kitchen & Bath Fixtures", "Microphones & Accessories", "Office Electronics", "Outdoor Storage & Housing", "Painting, Drawing & Art Supplies", "Pantry Staples", "Party Supplies", "Pest Control", "Pools, Hot Tubs & Supplies", "Test, Measure & Inspect", "Vision", "Accessories & Supplies", "Baby & Toddler Toys", "Car Care", "Dress Up & Pretend Play", "Fasteners", "GPS, Finders & Accessories", "Hydraulics, Pneumatics & Plumbing", "Occupational Health & Safety Products", "Reptiles & Amphibians", "Sewing", "Sports Fan Shop", "Stuffed Animals & Plush Toys", "Television & Video", "Toy Figures & Playsets", "Vacuums & Floor Care", "Video Projectors", "Backyard Birding & Wildlife", "Commercial Food Preparation Equipment", "Diapering", "Drums & Percussion", "Feeding", "Fish & Aquatic Pets", "Generators & Portable Power", "Household Batteries, Chargers & Accessories", "Industrial Electrical", "Keyboards & MIDI", "Kids' Electronics", "Knitting & Crochet", "Light Bulbs", "Lights, Bulbs & Indicators", "Medical Supplies & Equipment", "Mobility & Daily Living Aids", "Needlework", "PC", "Packaging & Shipping Supplies", "Paint & Paint Supplies", "Performance Parts & Accessories", "Plumbing", "Potty Training", "Power Finishing Tool Parts & Accessories", "Power Transmission Products", "Puzzles", "Raw Materials", "Retail Store Fixtures & Equipment", "Salon & Spa Equipment", "Scrapbooking & Stamping", "Small Animals", "Small Appliance Parts & Accessories", "Tricycles, Scooters & Wagons", "Vehicles", "Kitchen & Home Appliances", "Home Accessories", "Cooking & Dining", "Printers & Accessories", "Home Cinema, TV & Video", "Indoor Lighting", "Power, Garden & Hand Tools", "Car Parts", "Fitness", "Medication & Treatments", "Make-up", "Car Accessories", "Mobile Phones & Communication", "Bath & Body", "Dental Care", "Mowers & Outdoor Power Tools", "Gardening", "Hi-Fi & Home Audio", "Manicure & Pedicure", "Headphones, Earphones & Accessories", "Remote & App-Controlled Devices", "Sports Toys & Outdoor", "Storage & Organisation", "Wellness", "Office Supplies", "Bathroom", "Painting Supplies, Tools & Wall Treatments", "Motorbike Accessories & Parts", "Shaving & Hair Removal", "Garden Tools & Watering Equipment", "Calendars, Planners & Personal Organisers", "Envelopes & Mailing Supplies", "Home Care & Cleaning", "Office Paper Products", "Pens, Pencils & Writing Supplies", "Safety Equipment", "Barbecue & Outdoor Dining", "Fireplaces, Stoves & Accessories", "Garden Décor", "Home Textiles", "Material Handling Products", "Networking Devices", "Nintendo Switch", "Novelty & Special Use Clothing", "Nursing & Feeding", "Outdoor Lighting", "Professional Medical Supplies", "Car & Motorbike Care", "Drinks", "Fragrances", "Outdoor Heaters & Fire Pits", "Solar & Wind Energy", "String Lights", "Abrasive & Finishing Products", "Agricultural Equipment & Supplies", "Blu-ray", "Building & Construction Toys", "Components & Replacement Parts", "Desktops", "Diet & Nutrition", "General Music-Making Accessories", "Gifts & Merchandise", "Janitorial & Sanitation Supplies", "Jigsaws & Puzzles", "Microphones", "Movies", "Play Vehicles", "Portable Sound & Video", "Strollers, Prams & Accessories", "Beer, Wine & Spirits", "Bird & Wildlife Care", "Building Supplies", "Electronic Toys", "Food Cupboard", "Health & Baby Care", "Hobbies", "Ovens & Hobs", "Recording & Computer", "Sports Technology", "Storage & Home Organisation", "String Instruments", "Tablets", "Test & Measurement", "Thermometers & Meteorological Instruments", "Towing & Transporting", "Tyres & Rims", "Visual Care", "eBook Readers & Accessories", "eWriters", "Activity & Entertainment", "Agricultural Vehicle Parts & Equipment", "Artwork", "Bathroom Lighting", "Cleaning Supplies", "Cutting Tools", "Dolls & Accessories", "Furniture & Lighting", "Garden Furniture & Accessories", "Guitars & Gear", "Intimate Hygiene", "Lab & Scientific Products", "Legacy Systems", "Monitors", "Musical Toy Instruments", "Nappy Changing", "Novelty Jewellery", "PA & Stage", "Piano & Keyboard", "Play Figures", "Potty Training & Step Stools", "Puppets & Puppet Theatres", "Scanners & Accessories", "School & Educational Supplies", "Small Kitchen Appliances", "Supporters' Gear", "Washing Machines & Tumble Dryers", "Wind Instruments", "Home Décor", "Boating & Watersports", "Uniforms, Work & Safety", "Motorcycle Accessories & Parts", "Cell Phones & Accessories", "Team Sports", "Arts, Crafts & Sewing", "Outdoor Gear", "Televisions & Video", "Camera, Photo & Video", "Garden Structures & Germination Equipment", "Golf", "Horses", "Kitchen & Bathroom Fixtures", "Action Sports", "Barbecue Grills & Outdoor Cooking", "Lawn Mowers & Outdoor Power Tools", "Paint, Body & Trim", "Cycling", "Martial Arts & Combat Sports", "Oils & Fluids", "Guitars", "Leisure Sports & Game Room", "Remote- & App-Controlled Toys", "Snow & Ice Sports", "Stationery & Party Supplies", "Woodwind Instruments", "3D Printing & Scanning", "Action Figures, Maquettes & Busts", "Automotive Care", "Birds", "Farm & Ranch", "Filtration", "GPS & Navigation", "Home Audio", "Outdoor Play", "Racquet & Paddle Sports", "Bass Guitars", "Beverages", "Bikes, Scooters & Ride-Ons", "Collectible Toys", "Cooking & Baking Supplies", "Electronics for Kids", "Fragrance", "Herbs, Spices & Seasonings", "Irons, Steamers & Accessories", "Jams, Jellies & Sweet Spreads", "Keyboards & Pianos", "Nails", "Outdoor Heating & Cooling", "RV Parts & Accessories", "Snacks & Sweets", "Travel Gear", "Virtual Reality", "Xbox Series X", "Household Cleaning Tools & Vacuums", "Data Storage", "Keyboards, Mice & Input Devices", "Motorbikes, Accessories & Parts", "Hampers & Gourmet Gifts", "Karaoke Equipment", "Laundry, Steaming & Ironing", "Power Accessories", "Vegetarian", "Cooking Ingredients", "Motorhome Parts & Accessories", "Paintwork", "Shoe, Jewellery & Watch Accessories", "Toy Advent Calendars", "Transporting & Storage", "Water Features & Ponds", "Kitchen Storage & Organisation", "Kitchen Tools & Gadgets", "Coffee, Tea & Espresso", "Tableware", "Bakeware", "Garden Storage & Housing", "Sex & Sensuality", "Baby Foods", "Cookware", "Laptops", "Professional Dental Supplies", "Rope Lights", "Trailers", "Dairy, Eggs & Plant-Based Alternatives", "Fire Pits & Outdoor Fireplaces", "Insects", "Jams, Honey & Spreads", "Radio Communication", "Snow Removal", "Furniture & Decoration", "Storage and Organization", "Office Electronics Products", "Small Appliances", "Medication Remedies and Dietary Supplements", "Model Building", "Novelty & Special Use", "Beer & Wine Storage & Dispensers", "Car Seats & Accessories", "Condiments & Sauces", "Disc Sports", "Oils, Vinegars & Salad Dressings", "PlayStation 5", "Xbox Series X & S", "Vacuums and Floor Care", "Soothers & Teethers", "Bakery", "Carriers & Accessories", "Gifts & Keepsakes", "PlayStation 4", "Computers, Components & Accessories", "DJ & VJ Equipment", "Home Brewing & Wine Making", "Soft Toys", "Telephones, VoIP & Accessories", "Household Appliances", "Medication & Remedies", "Automotive Accessories", "Automotive Parts", "Components", "TVs, Home Cinema & Video", "Sport & Outdoor", "Vitamins & Supplements", "Bedding & Linen", "Fishing", "Boating & Water Sports", "Baby Care", "Portable Sound & Vision", "Gymnastics", "Household & Cleaning", "Plush", "Ponds & Water Gardens", "Sports Sunglasses", "Bags & Backpacks", "Boxing", "Soccer", "Backyard Livestock & Bee Care", "Bass Guitars & Gear", "Garden & Patio Furniture", "Intimate Care & Hygiene", "Printers, Ink & Accessories", "Waste & Recycling", "Wine, Beer & Spirits", "Winter Sports", "Billiards", "Cricket", "External Components", "Household Batteries & Chargers", "Newborn Gifts & Keepsakes", "Nintendo Switch 2", "School Supplies", "Scooters & Equipment", "Skateboarding", "Traditional & Cultural Wear" ] } }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands, e.g. Sony. Each brand is its own search.", "items": { "type": "string" } }, "sellers": { "title": "Seller IDs", "type": "array", "description": "Only deals from these Amazon sellers, by seller id (the sellerId field in results), to watch a competitor or supplier. Each seller is its own search.", "items": { "type": "string" } }, "collections": { "title": "Collections", "type": "array", "description": "DealSeek's ready-made lists, e.g. Today's Top Deals, Ending Soon or Under $5. Most exist in the US, UK, Canada and Germany; Top Deals and Top Promo Codes in every country.", "items": { "type": "string", "enumSuggestedValues": [ "beauty_skincare", "bedsure", "christmas-decor", "name_brand_steals", "rossen_reports", "thanksgiving", "top50_promo_codes", "top_50", "date_night_couples", "name_brand_tech", "promo-codes-only", "promo_codes_only", "ending_soon", "hot50_tech", "name_brand_sports", "ninja-deals", "hot50_snacks", "name_brand_toys", "under_5", "giveaway", "hot50_toys", "name_brand_beauty", "name_brand_household", "hot50_household", "over-40-off", "hot50_beauty", "kitchen", "name_brand_clothing", "tech", "hot50_sports", "top-deals", "toys_games", "cozy-home-essentials", "haul", "snacks", "furniture", "walmart-fashion-deals", "name-brand", "join-prime", "1-cent-deals", "1-cent-jewelry", "4th_of_july", "baby-essentials", "back_to_school_essentials", "best_deals_air_fryers", "best_deals_air_purifiers", "best_deals_board_games", "best_deals_coffee_makers", "best_deals_dog_toys", "best_deals_laptops", "best_deals_monitors", "best_deals_protein_powder", "best_deals_robot_vacuums", "best_deals_skincare", "best_deals_standing_desks", "best_deals_tvs", "best_deals_wireless_headphones", "cheap-haul-items", "dinosaur-gifts", "dom-deals", "dreame-deals", "dreame-prime-day", "eco-friendly-products", "ekouaer-deals", "ending_soon_beauty", "ending_soon_tech", "euhomy-prime-day", "fitness-test", "fitness_wellness", "fragrance", "g-gradual-deals", "gta-6-setup", "gym-essentials", "halloween", "halloween-decorations", "home_office_essentials", "labor-day-deals", "last-minute-halloween-candy", "merach-deals", "merach-prime-day", "name_brand_deals", "pet-finds", "pet_toys", "prime_day", "promo_guide_air_purifiers", "promo_guide_baby_products", "promo_guide_electronics", "promo_guide_headphones", "promo_guide_home_fitness", "promo_guide_kitchen_appliances", "promo_guide_pet_supplies", "promo_guide_skincare", "promo_guide_vitamins", "self_care_deals", "sports", "summer_deals", "testsnacks", "todays-trending-deals", "travel-essentials", "valentines-day", "valentines-test", "walmart-clearance-deals", "walmart-easter" ], "enumTitles": [ "Beauty & Skincare (beauty_skincare)", "Bedsure (bedsure)", "Christmas Decor (christmas-decor)", "Name Brand Steals (name_brand_steals)", "Rossen Reports (rossen_reports)", "Thanksgiving Finds (thanksgiving)", "Top Promo Codes (top50_promo_codes)", "Today's Top Deals (top_50)", "Date Night (date_night_couples)", "Name Brand Tech (name_brand_tech)", "Promo Codes Only (promo-codes-only)", "Promo Codes (promo_codes_only)", "Ending Soon (ending_soon)", "Tech (hot50_tech)", "Sports (Name Brand) (name_brand_sports)", "Ninja Deals (ninja-deals)", "Top Picks: Snacks (hot50_snacks)", "Toys & Games (Name Brand) (name_brand_toys)", "Under $5 (under_5)", "Giveaway (giveaway)", "Toys (hot50_toys)", "Beauty (Name Brand) (name_brand_beauty)", "Home Deals (name_brand_household)", "Household Essentials (hot50_household)", "Over 40% Off (over-40-off)", "Beauty (hot50_beauty)", "Kitchen (kitchen)", "Clothing (Name Brand) (name_brand_clothing)", "Tech & Electronics (tech)", "Sports (hot50_sports)", "Top Deals (top-deals)", "Toys & Games (toys_games)", "Cozy Home Essentials (cozy-home-essentials)", "Amazon Haul (haul)", "Snacks (snacks)", "Furniture (furniture)", "Walmart Fashion Deals (walmart-fashion-deals)", "Name Brand (name-brand)", "Join Prime (join-prime)", "1 Cent Deals (1-cent-deals)", "1 Cent Jewelry (1-cent-jewelry)", "4th of July (4th_of_july)", "Baby Essentials (baby-essentials)", "Back to School Essentials (back_to_school_essentials)", "Best Air Fryer Deals (best_deals_air_fryers)", "Best Air Purifier Deals (best_deals_air_purifiers)", "Best Board Game Deals (best_deals_board_games)", "Best Coffee Maker Deals (best_deals_coffee_makers)", "Best Dog Toy Deals (best_deals_dog_toys)", "Best Laptop Deals (best_deals_laptops)", "Best Monitor Deals (best_deals_monitors)", "Best Protein Powder Deals (best_deals_protein_powder)", "Best Robot Vacuum Deals (best_deals_robot_vacuums)", "Best Skincare Deals (best_deals_skincare)", "Best Standing Desk Deals (best_deals_standing_desks)", "Best TV Deals (best_deals_tvs)", "Best Wireless Headphones Deals (best_deals_wireless_headphones)", "Cheap Haul Items (cheap-haul-items)", "Dinosaur Gifts (dinosaur-gifts)", "Dom's Deals (dom-deals)", "Dreame Deals (dreame-deals)", "Top Dreame Deals (dreame-prime-day)", "Eco-friendly Products (eco-friendly-products)", "Ekouaer Deals (ekouaer-deals)", "Beauty Ending Soon (ending_soon_beauty)", "Tech Ending Soon (ending_soon_tech)", "Top Euhomy Deals (euhomy-prime-day)", "fitness test (fitness-test)", "Fitness & Wellness (fitness_wellness)", "Fragrance (fragrance)", "G Gradual Deals (g-gradual-deals)", "GTA 6 Setup (gta-6-setup)", "Gym Essentials (gym-essentials)", "Halloween (halloween)", "Halloween Deals (halloween-decorations)", "Home Office Essentials (home_office_essentials)", "Labor Day Deals (labor-day-deals)", "Last-Minute Halloween Candy (last-minute-halloween-candy)", "Merach Deals (merach-deals)", "Merach Prime Day (merach-prime-day)", "Name Brand Deals (name_brand_deals)", "Pet Finds (pet-finds)", "Pet Toys (pet_toys)", "Prime Day (prime_day)", "Air Purifiers Promo Guide (promo_guide_air_purifiers)", "Baby Products Promo Guide (promo_guide_baby_products)", "Electronics Promo Guide (promo_guide_electronics)", "Headphones Promo Guide (promo_guide_headphones)", "Home Fitness Promo Guide (promo_guide_home_fitness)", "Kitchen Appliances Promo Guide (promo_guide_kitchen_appliances)", "Pet Supplies Promo Guide (promo_guide_pet_supplies)", "Skincare Promo Guide (promo_guide_skincare)", "Vitamins & Supplements Promo Guide (promo_guide_vitamins)", "Self Care Deals (self_care_deals)", "Sports (sports)", "Summer Deals (summer_deals)", "TestSnacks (testsnacks)", "Today's Trending Deals! (todays-trending-deals)", "Travel Essentials (travel-essentials)", "Valentine's Day (valentines-day)", "valentines test (valentines-test)", "Walmart Clearance Deals (walmart-clearance-deals)", "Walmart Easter (walmart-easter)" ] } }, "asins": { "title": "Amazon products (ASINs)", "type": "array", "description": "Check specific products by Amazon id, e.g. B08D3V51K9. You get a row for each one that has a live deal, in the selected countries. Filters don't apply to these.", "items": { "type": "string" } }, "startUrls": { "title": "DealSeek links", "type": "array", "description": "Optional: paste DealSeek links from any country: a product, brand, collection, promo codes, top deals, Amazon, Walmart or eBay page.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "dealTypes": { "title": "Deal types", "type": "array", "description": "Only deals with at least one of these.", "items": { "type": "string", "enum": [ "promoCode", "coupon", "lightningDeal", "extraDiscount", "priceDrop", "subscribeAndSave" ], "enumTitles": [ "Promo codes", "Coupons", "Lightning deals", "Extra discounts", "Price drops", "Subscribe & Save" ] } }, "minPrice": { "title": "Minimum final price", "minimum": 0, "type": "number", "description": "Skip deals that end up cheaper than this, in the country's currency." }, "maxPrice": { "title": "Maximum final price", "minimum": 0, "type": "number", "description": "Skip deals that end up dearer than this, in the country's currency." }, "minDiscount": { "title": "Minimum discount %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only deals with at least this much off, counting every discount together." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only products rated at least this, out of 5." }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "type": "integer", "description": "Only products with at least this many reviews." }, "maxReviews": { "title": "Maximum reviews", "minimum": 0, "type": "integer", "description": "Only products with at most this many reviews, to find new sellers and products." }, "minBoughtLastMonth": { "title": "Minimum bought last month", "minimum": 0, "type": "integer", "description": "Only products bought at least this many times in the past month." }, "expiringWithinHours": { "title": "Expiring within (hours)", "minimum": 1, "type": "integer", "description": "Only deals ending within this many hours." }, "condition": { "title": "Condition", "enum": [ "new", "used", "refurbished" ], "type": "string", "description": "New, used or refurbished. Mostly for eBay and Walmart deals." }, "verifiedCodesOnly": { "title": "Verified promo codes only", "type": "boolean", "description": "Only deals whose promo code DealSeek has checked and confirmed.", "default": false }, "amazonChoiceOnly": { "title": "Amazon's Choice only", "type": "boolean", "description": "Only products with the Amazon's Choice badge.", "default": false }, "bestSellersOnly": { "title": "Best sellers only", "type": "boolean", "description": "Only products DealSeek marks as best sellers (few deals have this).", "default": false }, "lowestIn3MonthsOnly": { "title": "Lowest price in 3 months only", "type": "boolean", "description": "Only deals at their lowest price of the last 3 months.", "default": false }, "fulfilledByAmazonOnly": { "title": "Fulfilled by Amazon only", "type": "boolean", "description": "Only products Amazon itself ships.", "default": false }, "nameBrandsOnly": { "title": "Name brands only", "type": "boolean", "description": "Only products DealSeek counts as name brands.", "default": false }, "hotOnly": { "title": "Hot deals only", "type": "boolean", "description": "Only deals DealSeek marks as hot.", "default": false }, "sort": { "title": "Sort", "enum": [ "recommended", "popular", "priceLow", "priceHigh", "discount" ], "type": "string", "description": "Order of the results, as on DealSeek. Runs over 4,000 deals are read in price order instead, because the other orders repeat deals on deep pages and miss others.", "default": "recommended" }, "includeDescriptions": { "title": "Include product descriptions", "type": "boolean", "description": "Add each Amazon product's full description. Same price; a little slower.", "default": false }, "includePriceHistory": { "title": "Include price history", "type": "boolean", "description": "Add each product's price history, its lowest, highest and average price, and how far below average today's deal really is. Same price, but one extra request per deal: about 3 deals a second.", "default": false }, "onlyNew": { "title": "Only new deals", "type": "boolean", "description": "Skip deals that earlier runs of this same search already returned, so you never get or pay for the same deal twice. Turn it on for a scheduled run or a saved task to get only what's new each time. The first run works as usual and remembers what it returned, in your key-value store 'dealseek-scraper-only-new' (delete it to start over). A new price or code on a product counts as a new deal.", "default": false }, "maxItems": { "title": "Maximum deals", "minimum": 1, "type": "integer", "description": "Stop after this many deals. You are charged per deal.", "default": 100 }, "maxConcurrency": { "title": "Max parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Requests made at the same time. Keep it low to be polite to the website.", "default": 4 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }