{
  "properties": {
    "asins": {
      "description": "Amazon ASINs to fetch exactly. Each ASIN opens its own product page (/dp/{ASIN}) directly, never a keyword search.",
      "editor": "stringList",
      "example": [
        "B08N5WRWNW",
        "B09X7MPX8L"
      ],
      "items": {
        "type": "string"
      },
      "title": "ASINs",
      "type": "array"
    },
    "categoryNodeIds": {
      "description": "Amazon browse-node IDs. Each node builds a real category listing (/s?rh=n:{node}&fs=true), with a merchandising fallback only when Amazon renders no listing grid.",
      "editor": "stringList",
      "example": [
        "172282"
      ],
      "items": {
        "type": "string"
      },
      "title": "Category Node IDs",
      "type": "array"
    },
    "categoryUrls": {
      "description": "Amazon search, category, seller-profile, or exact product URLs. Search pages (/s?k=), browse nodes (/b?node=), seller profiles (/sp?seller=), and product pages (/dp/) are routed automatically. Combine with any other mode.",
      "editor": "stringList",
      "example": [
        "https://www.amazon.com/s?k=laptops",
        "https://www.amazon.com/dp/B08N5WRWNW"
      ],
      "items": {
        "type": "string"
      },
      "title": "Search, Category & Product URLs",
      "type": "array"
    },
    "includeSpecifications": {
      "default": true,
      "description": "If true (and detail pages are scraped), return the specifications object parsed from the overview and technical-detail tables.",
      "prefill": false,
      "title": "Include Specifications",
      "type": "boolean"
    },
    "includeSponsored": {
      "default": true,
      "description": "If true (default), sponsored/ad placements are included. Set false to return organic results only.",
      "title": "Include Sponsored Results",
      "type": "boolean"
    },
    "keywords": {
      "description": "Plain search keywords or phrases. Each keyword builds an Amazon search URL (/s?k={query}).",
      "editor": "stringList",
      "example": [
        "wireless earbuds",
        "bluetooth speaker"
      ],
      "items": {
        "type": "string"
      },
      "prefill": [
        "wireless earbuds"
      ],
      "title": "Search Keywords",
      "type": "array"
    },
    "marketplaceDomain": {
      "default": "amazon.com",
      "description": "Amazon marketplace used for keyword, ASIN, seller, and node modes. URLs in categoryUrls/productUrls keep their own marketplace.",
      "editor": "select",
      "enum": [
        "amazon.com",
        "amazon.co.uk",
        "amazon.de",
        "amazon.fr",
        "amazon.it",
        "amazon.es",
        "amazon.ca",
        "amazon.com.au",
        "amazon.co.jp",
        "amazon.in",
        "amazon.com.br",
        "amazon.com.mx",
        "amazon.nl",
        "amazon.se",
        "amazon.pl",
        "amazon.com.tr",
        "amazon.ae",
        "amazon.sa",
        "amazon.sg",
        "amazon.com.be",
        "amazon.eg"
      ],
      "enumTitles": [
        "United States (amazon.com)",
        "United Kingdom (amazon.co.uk)",
        "Germany (amazon.de)",
        "France (amazon.fr)",
        "Italy (amazon.it)",
        "Spain (amazon.es)",
        "Canada (amazon.ca)",
        "Australia (amazon.com.au)",
        "Japan (amazon.co.jp)",
        "India (amazon.in)",
        "Brazil (amazon.com.br)",
        "Mexico (amazon.com.mx)",
        "Netherlands (amazon.nl)",
        "Sweden (amazon.se)",
        "Poland (amazon.pl)",
        "Turkey (amazon.com.tr)",
        "United Arab Emirates (amazon.ae)",
        "Saudi Arabia (amazon.sa)",
        "Singapore (amazon.sg)",
        "Belgium (amazon.com.be)",
        "Egypt (amazon.eg)"
      ],
      "prefill": "amazon.com",
      "title": "Marketplace",
      "type": "string"
    },
    "maxItems": {
      "default": 0,
      "description": "Global cap across every source in the run. 0 means no global cap.",
      "editor": "number",
      "maximum": 100000,
      "minimum": 0,
      "prefill": 3,
      "title": "Maximum Items (all sources)",
      "type": "integer"
    },
    "maxItemsPerCategory": {
      "default": 10,
      "description": "Maximum products to return from each keyword, URL, seller, or node source.",
      "editor": "number",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum Items Per Source",
      "type": "integer"
    },
    "maxPages": {
      "default": 1,
      "description": "Maximum listing pages per source. Amazon keyword search itself stops at page 7; category listings go deeper.",
      "editor": "number",
      "maximum": 50,
      "minimum": 1,
      "title": "Maximum Pages",
      "type": "integer"
    },
    "minRating": {
      "description": "Only return products with a star rating at or above this value (0-5).",
      "editor": "number",
      "maximum": 5,
      "minimum": 0,
      "title": "Minimum Rating",
      "type": "number"
    },
    "onlyDeals": {
      "default": false,
      "description": "If true, only return products with visible deal evidence (coupon, limited-time-deal badge, or genuine strike-through list price).",
      "title": "Only Deals",
      "type": "boolean"
    },
    "priceMax": {
      "description": "Only return products priced at or below this amount (marketplace currency).",
      "editor": "number",
      "minimum": 0,
      "title": "Maximum Price",
      "type": "number"
    },
    "priceMin": {
      "description": "Only return products priced at or above this amount (marketplace currency).",
      "editor": "number",
      "minimum": 0,
      "title": "Minimum Price",
      "type": "number"
    },
    "primeOnly": {
      "default": false,
      "description": "If true, only return products with a visible Amazon Prime badge. Badges are render-dependent in some marketplaces.",
      "title": "Prime Only",
      "type": "boolean"
    },
    "productUrls": {
      "description": "Exact Amazon product URLs. Each URL is normalized to /dp/{ASIN} on its own marketplace and fetched directly (never as a search).",
      "editor": "stringList",
      "example": [
        "https://www.amazon.com/dp/B08N5WRWNW"
      ],
      "items": {
        "type": "string"
      },
      "title": "Product URLs",
      "type": "array"
    },
    "rateLimitDelay": {
      "default": 2,
      "description": "Base pacing delay between live requests. Product-detail requests always add human-like jitter.",
      "editor": "number",
      "maximum": 30,
      "minimum": 1,
      "title": "Base Request Delay (seconds)",
      "type": "integer"
    },
    "scrapeProductDetails": {
      "default": true,
      "description": "If true, visit each accepted product's own page for specs, gallery images, seller, BSR, variants, and histogram. ASIN/product-URL modes always use detail pages. If false, only listing-card fields are returned.",
      "prefill": false,
      "title": "Scrape Product Details",
      "type": "boolean"
    },
    "sellerIds": {
      "description": "Amazon seller/merchant IDs. Each ID builds that seller's storefront listing (/s?me={sellerId}).",
      "editor": "stringList",
      "example": [
        "A1B2C3D4E5F6G7"
      ],
      "items": {
        "type": "string"
      },
      "title": "Seller IDs",
      "type": "array"
    },
    "sortBy": {
      "default": "relevanceblender",
      "description": "Sort order applied to search and category listings.",
      "editor": "select",
      "enum": [
        "relevanceblender",
        "price-asc-rank",
        "price-desc-rank",
        "review-rank",
        "date-desc-rank",
        "exact-aware-popularity-rank"
      ],
      "enumTitles": [
        "Featured/Relevance",
        "Price: Low to High",
        "Price: High to Low",
        "Avg. Customer Review",
        "Newest Arrivals",
        "Best Sellers"
      ],
      "title": "Sort By",
      "type": "string"
    }
  },
  "required": [],
  "schemaVersion": 1,
  "title": "Amazon Listings Extractor Input",
  "type": "object"
}