{
  "description": "Search AliExpress by keyword, look up products and stores, or collect customer reviews across major shopper regions.",
  "properties": {
    "choiceOnly": {
      "default": false,
      "description": "Only show AliExpress Choice items.",
      "editor": "checkbox",
      "prefill": false,
      "title": "AliExpress Choice only",
      "type": "boolean"
    },
    "currency": {
      "default": "",
      "description": "Optional ISO-4217 currency. Leave blank to use the region's usual currency. The currency actually returned is recorded in every record.",
      "editor": "select",
      "enum": [
        "",
        "USD",
        "EUR",
        "GBP",
        "JPY",
        "CNY",
        "RUB",
        "BRL",
        "INR",
        "AUD",
        "CAD",
        "HKD",
        "TWD",
        "KRW",
        "SGD",
        "MXN",
        "ARS",
        "CLP",
        "COP",
        "PEN",
        "UYU",
        "ILS",
        "TRY",
        "AED",
        "SAR",
        "ZAR",
        "PLN",
        "CHF",
        "SEK",
        "NOK",
        "DKK",
        "CZK",
        "HUF",
        "RON",
        "THB",
        "VND",
        "PHP",
        "IDR",
        "MYR",
        "NZD",
        "PKR",
        "EGP",
        "NGN"
      ],
      "enumTitles": [
        "(use region currency)",
        "USD",
        "EUR",
        "GBP",
        "JPY",
        "CNY",
        "RUB",
        "BRL",
        "INR",
        "AUD",
        "CAD",
        "HKD",
        "TWD",
        "KRW",
        "SGD",
        "MXN",
        "ARS",
        "CLP",
        "COP",
        "PEN",
        "UYU",
        "ILS",
        "TRY",
        "AED",
        "SAR",
        "ZAR",
        "PLN",
        "CHF",
        "SEK",
        "NOK",
        "DKK",
        "CZK",
        "HUF",
        "RON",
        "THB",
        "VND",
        "PHP",
        "IDR",
        "MYR",
        "NZD",
        "PKR",
        "EGP",
        "NGN"
      ],
      "prefill": "USD",
      "title": "Currency override",
      "type": "string"
    },
    "fourStarPlus": {
      "default": false,
      "description": "Only show items rated 4.0 or higher. The actor enforces the 4.0 threshold after AliExpress returns its filtered page.",
      "editor": "checkbox",
      "prefill": false,
      "title": "4 stars and up only",
      "type": "boolean"
    },
    "freeShippingOnly": {
      "default": false,
      "description": "Only show items advertised with free shipping.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Free shipping only",
      "type": "boolean"
    },
    "includeProductStats": {
      "default": true,
      "description": "Add each product's average rating and total review count to review records.",
      "editor": "checkbox",
      "prefill": true,
      "title": "Include review summary",
      "type": "boolean"
    },
    "includeReviews": {
      "default": false,
      "description": "Fetch customer reviews for each product (slow and adds records to the product).",
      "editor": "checkbox",
      "prefill": false,
      "sectionCaption": "Reviews",
      "title": "Attach reviews",
      "type": "boolean"
    },
    "includeSponsored": {
      "default": true,
      "description": "Include promoted product cards; they are marked isSponsored in the output.",
      "editor": "checkbox",
      "prefill": true,
      "title": "Include sponsored results",
      "type": "boolean"
    },
    "includeWelcomeGifts": {
      "default": false,
      "description": "Include $0.00 new-shopper gift cards; they are marked isWelcomeGift and have no normal price.",
      "editor": "checkbox",
      "prefill": false,
      "title": "Include welcome-gift cards",
      "type": "boolean"
    },
    "language": {
      "default": "en_US",
      "description": "Storefront language and the language used to translate review text.",
      "editor": "select",
      "enum": [
        "en_US",
        "es_ES",
        "fr_FR",
        "de_DE",
        "it_IT",
        "pt_BR",
        "pt_PT",
        "ru_RU",
        "ja_JP",
        "ko_KR",
        "ar_MA",
        "tr_TR",
        "th_TH",
        "vi_VN",
        "id_ID",
        "nl_NL",
        "pl_PL",
        "iw_IL"
      ],
      "enumTitles": [
        "English (US)",
        "Spanish (Spain)",
        "French (France)",
        "German (Germany)",
        "Italian (Italy)",
        "Portuguese (Brazil)",
        "Portuguese (Portugal)",
        "Russian (Russia)",
        "Japanese (Japan)",
        "Korean (Korea)",
        "Arabic (Morocco)",
        "Turkish (Turkey)",
        "Thai (Thailand)",
        "Vietnamese (Vietnam)",
        "Indonesian (Indonesia)",
        "Dutch (Netherlands)",
        "Polish (Poland)",
        "Hebrew (Israel)"
      ],
      "prefill": "en_US",
      "title": "Language",
      "type": "string"
    },
    "maxItems": {
      "default": 100,
      "description": "Hard cap on records emitted by the run.",
      "editor": "number",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "sectionCaption": "Limits",
      "title": "Max items",
      "type": "integer"
    },
    "maxPages": {
      "default": 3,
      "description": "Maximum result pages per query (60 products per page, up to 60 pages).",
      "editor": "number",
      "maximum": 60,
      "minimum": 1,
      "prefill": 1,
      "title": "Max search pages",
      "type": "integer"
    },
    "maxReviewsPerProduct": {
      "default": 20,
      "description": "Review cap per product when reviews are fetched. 0 uses the default of 20.",
      "editor": "number",
      "maximum": 200,
      "minimum": 0,
      "prefill": 20,
      "title": "Max reviews per product",
      "type": "integer"
    },
    "mode": {
      "default": "search",
      "description": "What to collect. search: keyword results. byProduct: product lookup by ID or URL. byStore: store lookup. byReviews: customer reviews. byUrl: auto-detect from pasted AliExpress links.",
      "editor": "select",
      "enum": [
        "search",
        "byProduct",
        "byStore",
        "byReviews",
        "byUrl"
      ],
      "enumTitles": [
        "Search by keyword",
        "Look up products",
        "Look up stores",
        "Collect reviews",
        "Auto-detect from URLs"
      ],
      "prefill": "search",
      "sectionCaption": "Mode & Inputs",
      "title": "Mode",
      "type": "string"
    },
    "priceMax": {
      "default": 0,
      "description": "Maximum price in the selected currency. 0 disables the upper bound.",
      "maximum": 1000000,
      "minimum": 0,
      "prefill": 0,
      "title": "Maximum price",
      "type": "number"
    },
    "priceMin": {
      "default": 0,
      "description": "Minimum price in the selected currency. 0 disables the lower bound.",
      "maximum": 1000000,
      "minimum": 0,
      "prefill": 0,
      "title": "Minimum price",
      "type": "number"
    },
    "productIds": {
      "description": "Numeric AliExpress product IDs or item URLs. Both 1005… and 3256… ID formats are accepted.",
      "editor": "stringList",
      "prefill": [
        "1005010155028387"
      ],
      "title": "Product IDs or URLs (mode=byProduct or byReviews)",
      "type": "array"
    },
    "ratingMin": {
      "default": 0,
      "description": "Minimum star rating from 0 to 5. Products without a rating are skipped when a threshold is set.",
      "maximum": 5,
      "minimum": 0,
      "prefill": 0,
      "title": "Minimum rating",
      "type": "number"
    },
    "region": {
      "default": "US",
      "description": "Country used for prices, availability and the storefront locale. Global leaves the region to the requesting IP.",
      "editor": "select",
      "enumSuggestedValues": [
        "US",
        "GB",
        "DE",
        "FR",
        "ES",
        "IT",
        "NL",
        "PT",
        "PL",
        "BR",
        "MX",
        "CA",
        "AU",
        "JP",
        "KR",
        "TR",
        "SA",
        "AE",
        "IL",
        "GLOBAL"
      ],
      "prefill": "US",
      "sectionCaption": "Region & Locale",
      "title": "Shopper region",
      "type": "string"
    },
    "reviewFilter": {
      "default": "all",
      "description": "Which reviews to collect.",
      "editor": "select",
      "enum": [
        "all",
        "withPhotos",
        "additional"
      ],
      "enumTitles": [
        "All reviews",
        "With photos",
        "With follow-up"
      ],
      "prefill": "all",
      "title": "Review filter",
      "type": "string"
    },
    "searchQueries": {
      "description": "One or more keywords, e.g. \"phone case\" or \"wireless earbuds\". Each query is scraped up to maxPages pages.",
      "editor": "stringList",
      "prefill": [
        "phone case"
      ],
      "title": "Search queries (mode=search)",
      "type": "array"
    },
    "shipFrom": {
      "default": "",
      "description": "Only show items stocked in this country. Leave blank for any warehouse.",
      "editor": "select",
      "enum": [
        "",
        "CN",
        "US",
        "RU",
        "ES",
        "FR",
        "DE",
        "IT",
        "GB",
        "PL",
        "TR",
        "BR",
        "JP",
        "KR",
        "AU",
        "CA",
        "MX",
        "AE",
        "SA",
        "IL",
        "TH",
        "VN",
        "ID",
        "MY",
        "NL",
        "BE",
        "PT"
      ],
      "enumTitles": [
        "(any warehouse)",
        "CN",
        "US",
        "RU",
        "ES",
        "FR",
        "DE",
        "IT",
        "GB",
        "PL",
        "TR",
        "BR",
        "JP",
        "KR",
        "AU",
        "CA",
        "MX",
        "AE",
        "SA",
        "IL",
        "TH",
        "VN",
        "ID",
        "MY",
        "NL",
        "BE",
        "PT"
      ],
      "prefill": "",
      "title": "Ship from country",
      "type": "string"
    },
    "sortBy": {
      "default": "default",
      "description": "How keyword results are ordered. AliExpress does not expose a newest sort.",
      "editor": "select",
      "enumSuggestedValues": [
        "default",
        "orders_desc",
        "price_asc",
        "price_desc",
        "newest"
      ],
      "prefill": "default",
      "sectionCaption": "Filters",
      "title": "Sort order (mode=search)",
      "type": "string"
    },
    "storeIds": {
      "description": "Numeric store IDs or /store/… URLs.",
      "editor": "stringList",
      "prefill": [
        "1101493050"
      ],
      "title": "Store IDs or URLs (mode=byStore)",
      "type": "array"
    },
    "urls": {
      "description": "Any mix of search, item, store and review URLs. The mode is detected per URL.",
      "editor": "stringList",
      "prefill": [
        "https://www.aliexpress.com/item/1005010155028387.html"
      ],
      "title": "AliExpress URLs (mode=byUrl)",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "AliExpress Scraper Input",
  "type": "object"
}