{ "description": "Provide products (URLs or ASINs) and/or discovery inputs (keyword terms, search URLs, bestseller lists). Locale, currency, delivery ZIP, and search filters are optional.", "properties": { "asins": { "default": [], "description": "Bare 10-character Amazon ASINs. Builds /dp/{ASIN} URLs on the selected marketplace, or on every domain listed in `domains` for cross-marketplace runs.", "editor": "stringList", "example": [ "B0B8PD8TTP" ], "items": { "type": "string" }, "prefill": [ "B09X7MPX8L" ], "title": "ASINs", "type": "array" }, "bestsellerUrls": { "default": [], "description": "Amazon bestseller /zgbs/ or /gp/bestsellers/ list URLs. Returns the ranked product cards, optionally enriched with product-detail fields.", "editor": "stringList", "example": [ "https://www.amazon.com/gp/bestsellers/kitchen/" ], "items": { "type": "string" }, "prefill": [], "title": "Bestseller List URLs", "type": "array" }, "brand": { "default": "", "description": "Optional brand word added to keyword search terms and used as a title/brand post-filter. This is not a structured Amazon brand-facet resolver.", "editor": "textfield", "example": "Anker", "prefill": "", "title": "Brand / Keyword Refinement", "type": "string" }, "condition": { "default": "any", "description": "Item condition filter for keyword searches. `new` is live-validated; other values are best effort.", "editor": "select", "enum": [ "any", "new", "used", "renewed", "collectible" ], "enumTitles": [ "Any condition", "New", "Used", "Renewed", "Collectible" ], "prefill": "any", "title": "Condition", "type": "string" }, "currency": { "default": "auto", "description": "ISO currency for the displayed price. `auto` uses the marketplace currency. Note: Amazon converts display currency; it is not guaranteed local retail pricing.", "editor": "select", "enum": [ "auto", "USD", "EUR", "GBP", "JPY", "CAD", "AUD", "INR", "BRL", "MXN", "SEK", "PLN", "TRY", "AED", "SAR", "EGP", "SGD", "CNY", "CHF", "HKD", "NZD", "ZAR", "NOK", "DKK", "CZK", "HUF", "ILS", "KRW", "THB", "MYR", "PHP", "IDR", "VND" ], "enumTitles": [ "Auto (marketplace currency)", "US Dollar", "Euro", "British Pound", "Japanese Yen", "Canadian Dollar", "Australian Dollar", "Indian Rupee", "Brazilian Real", "Mexican Peso", "Swedish Krona", "Polish Zloty", "Turkish Lira", "UAE Dirham", "Saudi Riyal", "Egyptian Pound", "Singapore Dollar", "Chinese Yuan", "Swiss Franc", "Hong Kong Dollar", "New Zealand Dollar", "South African Rand", "Norwegian Krone", "Danish Krone", "Czech Koruna", "Hungarian Forint", "Israeli Shekel", "South Korean Won", "Thai Baht", "Malaysian Ringgit", "Philippine Peso", "Indonesian Rupiah", "Vietnamese Dong" ], "prefill": "auto", "title": "Display Currency", "type": "string" }, "dealsOnly": { "default": false, "description": "Apply Amazon's deals filter to keyword searches. Only affects discovery.", "prefill": false, "title": "Deals Only", "type": "boolean" }, "deliveryCountry": { "default": "auto", "description": "Optional country hint. When `postalCode` is empty, a representative local ZIP for that country is used. A country alone is not sent to Amazon.", "editor": "select", "enum": [ "auto", "AU", "BE", "BR", "CA", "DE", "EG", "ES", "FR", "GB", "IN", "IT", "JP", "MX", "NL", "PL", "SA", "SE", "SG", "TR", "AE", "US" ], "enumTitles": [ "Auto (marketplace default)", "Australia", "Belgium", "Brazil", "Canada", "Germany", "Egypt", "Spain", "France", "United Kingdom", "India", "Italy", "Japan", "Mexico", "Netherlands", "Poland", "Saudi Arabia", "Sweden", "Singapore", "Turkey", "United Arab Emirates", "United States" ], "prefill": "auto", "sectionCaption": "Delivery", "title": "Delivery Country", "type": "string" }, "domains": { "default": [], "description": "Optional list of marketplaces (e.g. amazon.com, amazon.de) to run bare ASINs and search terms across. Leave empty to use `marketplace` only.", "editor": "stringList", "example": [ "amazon.com", "amazon.de" ], "items": { "type": "string" }, "prefill": [], "title": "Additional Domains", "type": "array" }, "failOnEmpty": { "default": false, "description": "Mark the run as FAILED when no product/search records are emitted.", "prefill": true, "title": "Fail on Empty", "type": "boolean" }, "includeDetails": { "default": true, "description": "Fetch each discovery result's product page for full price, seller, variants, specs, reviews, and media fields. Disable for a cheaper search-card-only run.", "prefill": true, "sectionCaption": "Output", "title": "Fetch Product Details", "type": "boolean" }, "includeFailed": { "default": true, "description": "Emit an error row (recordType=error, reason, httpStatus) when a product or discovery input fails instead of silently dropping it.", "prefill": true, "title": "Include Failure Rows", "type": "boolean" }, "includeSponsored": { "default": true, "description": "Keep sponsored search cards. The isSponsored flag is always preserved.", "prefill": true, "title": "Include Sponsored Results", "type": "boolean" }, "includeTopReviews": { "default": true, "description": "Include the inline top-review snippets Amazon renders publicly. Full review pagination is login-gated and is not supported.", "prefill": false, "title": "Include Top Reviews", "type": "boolean" }, "includeVariants": { "default": true, "description": "Include parent ASIN, child ASINs, and variant dimensions. Per-variant price and stock are not available from the product page.", "prefill": false, "title": "Include Variants", "type": "boolean" }, "language": { "default": "auto", "description": "Page language. `auto` uses the marketplace's own default. Explicit values set `?language=` and the matching Accept-Language header.", "editor": "select", "enum": [ "auto", "en_US", "en_GB", "en_CA", "en_AU", "en_IN", "en_SG", "de_DE", "fr_FR", "it_IT", "es_ES", "es_MX", "pt_BR", "nl_NL", "nl_BE", "sv_SE", "pl_PL", "tr_TR", "ja_JP", "ar_AE", "ar_SA", "ar_EG" ], "enumTitles": [ "Auto (marketplace default)", "English (US)", "English (UK)", "English (Canada)", "English (Australia)", "English (India)", "English (Singapore)", "German", "French", "Italian", "Spanish (Spain)", "Spanish (Mexico)", "Portuguese (Brazil)", "Dutch (Netherlands)", "Dutch (Belgium)", "Swedish", "Polish", "Turkish", "Japanese", "Arabic (UAE)", "Arabic (Saudi Arabia)", "Arabic (Egypt)" ], "prefill": "auto", "title": "Language", "type": "string" }, "marketplace": { "default": "auto", "description": "Marketplace used for bare ASINs and keyword search terms. `auto` uses the first product URL's domain, or amazon.com.", "editor": "select", "enum": [ "auto", "amazon.com", "amazon.ca", "amazon.com.mx", "amazon.com.br", "amazon.co.uk", "amazon.de", "amazon.fr", "amazon.it", "amazon.es", "amazon.nl", "amazon.com.be", "amazon.se", "amazon.pl", "amazon.com.tr", "amazon.ae", "amazon.sa", "amazon.eg", "amazon.in", "amazon.co.jp", "amazon.com.au", "amazon.sg" ], "enumTitles": [ "Auto (from input URLs)", "United States", "Canada", "Mexico", "Brazil", "United Kingdom", "Germany", "France", "Italy", "Spain", "Netherlands", "Belgium", "Sweden", "Poland", "Turkey", "United Arab Emirates", "Saudi Arabia", "Egypt", "India", "Japan", "Australia", "Singapore" ], "prefill": "auto", "sectionCaption": "Marketplace & Locale", "title": "Marketplace", "type": "string" }, "maxItems": { "default": 50, "description": "Maximum number of search/bestseller rows across all discovery inputs. Explicit product URLs/ASINs are always processed.", "maximum": 1000, "minimum": 1, "prefill": 1, "sectionCaption": "Limits", "title": "Max Discovery Items", "type": "integer" }, "maxPages": { "default": 3, "description": "Maximum search-result pages to read per keyword or search URL (1-20).", "maximum": 20, "minimum": 1, "prefill": 1, "title": "Max Pages per Query", "type": "integer" }, "maxPrice": { "description": "Maximum price for discovery (search) results. Leave empty for no upper bound.", "editor": "number", "maximum": 1000000, "minimum": 0, "title": "Maximum Price", "type": "number" }, "minPrice": { "description": "Minimum price for discovery (search) results. Leave empty for no lower bound.", "editor": "number", "maximum": 1000000, "minimum": 0, "sectionCaption": "Discovery Filters", "title": "Minimum Price", "type": "number" }, "minRating": { "default": "any", "description": "Minimum star rating for discovery results. `4` is the live-validated 4+ stars filter; lower values are best effort.", "editor": "select", "enum": [ "any", "4", "3", "2", "1" ], "enumTitles": [ "Any rating", "4 stars and up", "3 stars and up", "2 stars and up", "1 star and up" ], "prefill": "any", "title": "Minimum Rating", "type": "string" }, "postalCode": { "default": "", "description": "Local ZIP/postal code for the delivery location. The actor validates it against the marketplace format and skips the location change if it does not match.", "editor": "textfield", "example": "10001", "prefill": "", "title": "Postal Code", "type": "string" }, "primeOnly": { "default": false, "description": "Apply Amazon's Prime filter to keyword searches. Prime eligibility itself is not emitted because the page does not expose a reliable per-item signal.", "prefill": false, "title": "Prime Only", "type": "boolean" }, "productUrls": { "default": [], "description": "Amazon product URLs to scrape. Any mix of the 21 supported country domains is allowed, e.g. https://www.amazon.com/dp/B0B8PD8TTP.", "editor": "stringList", "example": [ "https://www.amazon.com/dp/B0B8PD8TTP", "https://www.amazon.de/dp/B008F7WGCK" ], "items": { "type": "string" }, "prefill": [], "sectionCaption": "Inputs", "title": "Product URLs", "type": "array" }, "proxyConfiguration": { "default": { "useApifyProxy": true }, "description": "Optional. The actor starts direct and escalates through Apify Proxy automatically only if Amazon blocks the request. No setup is required.", "editor": "proxy", "prefill": { "useApifyProxy": true }, "sectionCaption": "Proxy", "title": "Proxy Configuration", "type": "object" }, "proxyCountry": { "default": "AUTO", "description": "Optional proxy exit country. `AUTO` uses the marketplace's own country for every domain.", "editor": "select", "enum": [ "AUTO", "US", "GB", "DE", "FR", "ES", "IT", "CA", "AU", "JP", "IN", "BR", "MX", "NL", "SE", "PL", "TR", "AE", "SA", "SG", "BE", "EG" ], "enumTitles": [ "Auto (per marketplace)", "United States", "United Kingdom", "Germany", "France", "Spain", "Italy", "Canada", "Australia", "Japan", "India", "Brazil", "Mexico", "Netherlands", "Sweden", "Poland", "Turkey", "United Arab Emirates", "Saudi Arabia", "Singapore", "Belgium", "Egypt" ], "prefill": "AUTO", "title": "Proxy Country", "type": "string" }, "rateLimitDelay": { "default": 1, "description": "Base pause in seconds between product/search requests (0-10). A random value between this and twice this is used.", "maximum": 10, "minimum": 0, "prefill": 0, "sectionCaption": "Performance", "title": "Delay Between Requests", "type": "integer" }, "searchTerms": { "default": [], "description": "Keyword queries to run on Amazon search pages. Price/rating/deal/condition/sort filters are applied as URL parameters.", "editor": "stringList", "example": [ "air fryer", "noise cancelling headphones" ], "items": { "type": "string" }, "prefill": [], "sectionCaption": "Discovery", "title": "Search Terms", "type": "array" }, "searchUrls": { "default": [], "description": "Full Amazon search URLs to pass through, including your own `i=`, `rh=`, `low-price`, and `s=` parameters. Pagination is added automatically.", "editor": "stringList", "example": [ "https://www.amazon.com/s?k=air+fryer&rh=p_72:1248909011" ], "items": { "type": "string" }, "prefill": [], "title": "Search URLs", "type": "array" }, "sortBy": { "default": "relevance", "description": "Sort order for keyword searches. Search-URL pass-through keeps its own sort.", "editor": "select", "enum": [ "relevance", "price-asc", "price-desc", "review-rank", "newest" ], "enumTitles": [ "Relevance", "Price: low to high", "Price: high to low", "Average review", "Newest arrivals" ], "prefill": "relevance", "title": "Sort By", "type": "string" }, "stock": { "default": "any", "description": "Best-effort stock filter applied after parsing. Records with unknown stock pass through.", "editor": "select", "enum": [ "any", "inStock", "outOfStock" ], "enumTitles": [ "Any stock", "In stock only", "Out of stock only" ], "prefill": "any", "title": "Stock", "type": "string" } }, "required": [], "schemaVersion": 1, "title": "Amazon Multi-Domain Product Price & Detail Scraper Input", "type": "object" }