{
  "openapi": "3.0.1",
  "info": {
    "title": "AliExpress Image Search Scraper",
    "description": "AliExpress image search scraper that also does 1688 image search and Alibaba image search. Give it a product photo and find the matching products, one row each: price, minimum order, units sold, supplier, factory and audit flags, link. Up to 500 per photo on each site. $0.33 per 1,000 products.",
    "version": "0.1",
    "x-build-id": "nHC9rzMzNNg5XBaEF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dami_studio~1688-alibaba-aliexpress-image-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dami_studio-1688-alibaba-aliexpress-image-search-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/dami_studio~1688-alibaba-aliexpress-image-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-dami_studio-1688-alibaba-aliexpress-image-search-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/dami_studio~1688-alibaba-aliexpress-image-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-dami_studio-1688-alibaba-aliexpress-image-search-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": {
          "imageUrls": {
            "title": "Picture links",
            "type": "array",
            "description": "Direct links to product pictures (JPG, PNG, WebP, GIF or BMP, up to 10 MB each), one per line. A picture from an Amazon, Shopify, TikTok Shop or AliExpress listing works, and so does your own photo. A link to a product page is not a picture: open the picture itself and copy its address. data: URLs and base64 also work. Up to 100 pictures a run.",
            "items": {
              "type": "string"
            }
          },
          "pictureStores": {
            "title": "Or pictures saved in a key-value store",
            "type": "array",
            "description": "For pictures on your computer: open Storage, then Key-value stores, click Create new, add the pictures with the store's Upload button, and pick that store here. Every JPG, PNG, WebP, GIF or BMP in it is searched. Up to 100 pictures a run, links included."
          },
          "offerIds": {
            "title": "1688 offers by id or link",
            "type": "array",
            "description": "Look 1688 offers up directly: offer ids or detail.1688.com links, one per line. Each comes back as one row with its product page, charged as a product page. Up to 100 a run.",
            "items": {
              "type": "string"
            }
          },
          "similarToOffers": {
            "title": "Or find products like these 1688 offers",
            "type": "array",
            "description": "1688 offer ids or links, one per line. Each offer's main picture is searched like a picture link, on the marketplaces picked below.",
            "items": {
              "type": "string"
            }
          },
          "marketplaces": {
            "title": "Marketplaces",
            "type": "array",
            "description": "Where to look for each picture: 1688, Alibaba.com and AliExpress by default. Other online stores worldwide adds products that look like the picture on stores across the web, each with its title, link, picture and store, without a price.",
            "items": {
              "type": "string",
              "enum": [
                "1688",
                "alibaba",
                "aliexpress",
                "otherStores"
              ],
              "enumTitles": [
                "1688 (China wholesale)",
                "Alibaba.com",
                "AliExpress",
                "Other online stores worldwide"
              ]
            },
            "default": [
              "1688",
              "alibaba",
              "aliexpress"
            ]
          },
          "maxResultsPerImage": {
            "title": "Products per picture, per marketplace",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How many matching products to keep for each picture on each marketplace, most similar first. 1688 lists up to about 700 for a picture, Alibaba.com a few thousand, AliExpress a few hundred.",
            "default": 20
          },
          "maxItems": {
            "title": "Most products in the run",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "A hard ceiling on rows, and so on the bill, across every picture and marketplace.",
            "default": 1000
          },
          "maxImages": {
            "title": "Most pictures in the run",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many pictures the run searches. They count in this order: picture links, then the 1688 offers to find similar products for, then the pictures in your key-value stores. The rest are left out with a free note.",
            "default": 100
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "relevance",
              "sales",
              "priceAsc",
              "priceDesc"
            ],
            "type": "string",
            "description": "Most similar first, best sellers first, or by price. Alibaba.com's picture search has no sort of its own, so its rows keep Alibaba.com's order.",
            "default": "relevance"
          },
          "minPriceCny": {
            "title": "1688: minimum price (yuan)",
            "minimum": 0,
            "type": "number",
            "description": "Leave out 1688 products priced below this, in Chinese yuan. Rows left out are not charged."
          },
          "maxPriceCny": {
            "title": "1688: maximum price (yuan)",
            "minimum": 0,
            "type": "number",
            "description": "Leave out 1688 products priced above this, in Chinese yuan."
          },
          "minPrice": {
            "title": "Alibaba.com and AliExpress: minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Leave out products priced below this, in the currency picked below."
          },
          "maxPrice": {
            "title": "Alibaba.com and AliExpress: maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Leave out products priced above this, in the currency picked below."
          },
          "maxMoq": {
            "title": "Largest minimum order",
            "minimum": 1,
            "type": "integer",
            "description": "Keep 1688 and Alibaba.com products you can order in this quantity or fewer. AliExpress sells single items, so it has no minimum order."
          },
          "manufacturersOnly": {
            "title": "Manufacturers only",
            "type": "boolean",
            "description": "Keep products from suppliers listed as manufacturers: on 1688 a production business or a super factory, on Alibaba.com its own manufacturers filter. AliExpress shops are left out when this is on.",
            "default": false
          },
          "verifiedSuppliersOnly": {
            "title": "Audited or verified suppliers only",
            "type": "boolean",
            "description": "Keep 1688 suppliers with a factory or business audit and Alibaba.com's verified suppliers. AliExpress shops are left out when this is on.",
            "default": false
          },
          "provinces": {
            "title": "1688: supplier provinces",
            "type": "array",
            "description": "Keep 1688 suppliers from these provinces only. Empty means all of China.",
            "items": {
              "type": "string",
              "enum": [
                "广东",
                "浙江",
                "江苏",
                "福建",
                "山东",
                "上海",
                "北京",
                "天津",
                "河北",
                "河南",
                "湖北",
                "湖南",
                "安徽",
                "江西",
                "四川",
                "重庆",
                "广西",
                "海南",
                "辽宁",
                "吉林",
                "黑龙江",
                "山西",
                "陕西",
                "甘肃",
                "宁夏",
                "青海",
                "新疆",
                "西藏",
                "云南",
                "贵州",
                "内蒙古",
                "香港",
                "澳门",
                "台湾"
              ],
              "enumTitles": [
                "Guangdong 广东",
                "Zhejiang 浙江",
                "Jiangsu 江苏",
                "Fujian 福建",
                "Shandong 山东",
                "Shanghai 上海",
                "Beijing 北京",
                "Tianjin 天津",
                "Hebei 河北",
                "Henan 河南",
                "Hubei 湖北",
                "Hunan 湖南",
                "Anhui 安徽",
                "Jiangxi 江西",
                "Sichuan 四川",
                "Chongqing 重庆",
                "Guangxi 广西",
                "Hainan 海南",
                "Liaoning 辽宁",
                "Jilin 吉林",
                "Heilongjiang 黑龙江",
                "Shanxi 山西",
                "Shaanxi 陕西",
                "Gansu 甘肃",
                "Ningxia 宁夏",
                "Qinghai 青海",
                "Xinjiang 新疆",
                "Tibet 西藏",
                "Yunnan 云南",
                "Guizhou 贵州",
                "Inner Mongolia 内蒙古",
                "Hong Kong 香港",
                "Macau 澳门",
                "Taiwan 台湾"
              ]
            }
          },
          "cities": {
            "title": "1688: supplier cities",
            "type": "array",
            "description": "Keep 1688 suppliers in these cities only, from 1688's own city list. Empty means all of China.",
            "items": {
              "type": "string",
              "enum": [
                "广州",
                "深圳",
                "珠海",
                "潮州",
                "中山",
                "东莞",
                "佛山",
                "惠州",
                "汕头",
                "汕尾",
                "韶关",
                "湛江",
                "肇庆",
                "河源",
                "江门",
                "揭阳",
                "茂名",
                "梅州",
                "清远",
                "阳江",
                "云浮",
                "杭州",
                "宁波",
                "温州",
                "绍兴",
                "台州",
                "嘉兴",
                "金华",
                "丽水",
                "湖州",
                "衢州",
                "舟山",
                "南京",
                "苏州",
                "无锡",
                "常州",
                "淮安",
                "镇江",
                "扬州",
                "徐州",
                "连云港",
                "南通",
                "宿迁",
                "泰州",
                "盐城",
                "济南",
                "青岛",
                "烟台",
                "济宁",
                "滨州",
                "莱芜",
                "日照",
                "潍坊",
                "淄博",
                "德州",
                "威海",
                "东营",
                "菏泽",
                "聊城",
                "临沂",
                "泰安",
                "枣庄",
                "石家庄",
                "保定",
                "沧州",
                "秦皇岛",
                "承德",
                "邯郸",
                "唐山",
                "邢台",
                "廊坊",
                "衡水",
                "张家口",
                "郑州",
                "洛阳",
                "开封",
                "焦作",
                "安阳",
                "南阳",
                "周口",
                "商丘",
                "新乡",
                "鹤壁",
                "平顶山",
                "三门峡",
                "信阳",
                "许昌",
                "驻马店",
                "漯河",
                "濮阳",
                "福州",
                "厦门",
                "泉州",
                "漳州",
                "龙岩",
                "南平",
                "宁德",
                "莆田",
                "三明",
                "沈阳",
                "大连",
                "鞍山",
                "丹东",
                "抚顺",
                "本溪",
                "朝阳",
                "铁岭",
                "锦州",
                "辽阳",
                "阜新",
                "葫芦岛",
                "盘锦",
                "营口",
                "合肥",
                "芜湖",
                "马鞍山",
                "淮南",
                "蚌埠",
                "黄山",
                "阜阳",
                "淮北",
                "铜陵",
                "亳州",
                "宣城",
                "安庆",
                "巢湖",
                "池州",
                "六安",
                "滁州",
                "宿州",
                "南宁",
                "桂林",
                "北海",
                "柳州",
                "梧州",
                "玉林",
                "百色",
                "崇左",
                "贵港",
                "河池",
                "贺州",
                "来宾",
                "防城港",
                "钦州",
                "太原",
                "大同",
                "晋城",
                "晋中",
                "临汾",
                "吕梁",
                "朔州",
                "长治",
                "忻州",
                "阳泉",
                "运城",
                "海口",
                "三亚",
                "琼海",
                "东方",
                "儋州",
                "万宁",
                "文昌",
                "定安县",
                "五指山",
                "屯昌县",
                "澄迈县",
                "临高县",
                "白沙黎族自治县",
                "昌江黎族自治县",
                "乐东黎族自治县",
                "陵水黎族自治县",
                "琼中黎族苗族自治县",
                "保亭黎族苗族自治县",
                "呼和浩特",
                "包头",
                "赤峰",
                "鄂尔多斯",
                "呼伦贝尔",
                "阿拉善盟",
                "通辽",
                "乌海",
                "兴安盟",
                "巴彦淖尔",
                "乌兰察布盟",
                "锡林郭勒盟",
                "长春",
                "吉林",
                "四平",
                "通化",
                "白城",
                "白山",
                "辽源",
                "松原",
                "延边朝鲜族自治州",
                "哈尔滨",
                "大庆",
                "佳木斯",
                "鹤岗",
                "牡丹江",
                "黑河",
                "鸡西",
                "七台河",
                "齐齐哈尔",
                "双鸭山",
                "绥化",
                "伊春",
                "大兴安岭",
                "武汉",
                "黄冈",
                "黄石",
                "荆门",
                "荆州",
                "潜江",
                "宜昌",
                "鄂州",
                "十堰",
                "随州",
                "天门",
                "仙桃",
                "咸宁",
                "襄樊",
                "孝感",
                "神农架林区",
                "恩施土家族苗族自治州",
                "长沙",
                "常德",
                "株洲",
                "岳阳",
                "郴州",
                "怀化",
                "湘潭",
                "张家界",
                "衡阳",
                "娄底",
                "邵阳",
                "益阳",
                "永州",
                "湘西土家族苗族自治州",
                "南昌",
                "上饶",
                "抚州",
                "赣州",
                "九江",
                "鹰潭",
                "吉安",
                "景德镇",
                "萍乡",
                "新余",
                "宜春",
                "银川",
                "固原",
                "石嘴山",
                "吴忠",
                "中卫",
                "乌鲁木齐",
                "哈密",
                "和田",
                "喀什",
                "吐鲁番",
                "阿克苏",
                "阿拉尔",
                "石河子",
                "五家渠",
                "克拉玛依",
                "图木舒克",
                "昌吉回族自治州",
                "伊犁哈萨克自治州",
                "巴音郭楞蒙古自治州",
                "博尔塔拉蒙古自治州",
                "克孜勒苏柯尔克孜自治州",
                "塔城地区",
                "阿勒泰地区",
                "西宁",
                "海东",
                "果洛藏族自治州",
                "海北藏族自治州",
                "海南藏族自治州",
                "黄南藏族自治州",
                "玉树藏族自治州",
                "海西蒙古族藏族自治州",
                "西安",
                "咸阳",
                "汉中",
                "安康",
                "宝鸡",
                "商洛",
                "铜川",
                "渭南",
                "延安",
                "榆林",
                "兰州",
                "白银",
                "酒泉",
                "定西",
                "嘉峪关",
                "金昌",
                "庆阳",
                "陇南",
                "平凉",
                "天水",
                "武威",
                "张掖",
                "甘南藏族自治州",
                "临夏回族自治州",
                "成都",
                "宜宾",
                "绵阳",
                "巴中",
                "攀枝花",
                "达州",
                "德阳",
                "遂宁",
                "广安",
                "广元",
                "乐山",
                "泸州",
                "眉山",
                "南充",
                "内江",
                "雅安",
                "资阳",
                "自贡",
                "甘孜藏族自治州",
                "凉山彝族自治州",
                "阿坝藏族羌族自治州",
                "昆明",
                "保山",
                "丽江",
                "玉溪",
                "昭通",
                "临沧",
                "曲靖",
                "普洱",
                "楚雄彝族自治州",
                "大理白族自治州",
                "迪庆藏族自治州",
                "怒江傈傈族自治州",
                "文山壮族苗族自治州",
                "西双版纳傣族自治州",
                "德宏傣族景颇族自治州",
                "红河哈尼族彝族自治州",
                "贵阳",
                "安顺",
                "毕节",
                "铜仁",
                "遵义",
                "六盘水",
                "黔东南苗族侗族自治州",
                "黔南布依族苗族自治州",
                "黔西南布依族苗族自治州",
                "拉萨",
                "阿里",
                "昌都",
                "林芝",
                "那曲",
                "日喀则",
                "山南",
                "香港岛",
                "九龙",
                "新界",
                "澳门半岛",
                "澳门离岛",
                "台北县",
                "宜兰县",
                "桃园县",
                "新竹县",
                "苗栗县",
                "台中县",
                "彰化县",
                "南投县",
                "云林县",
                "嘉义县",
                "台南县",
                "高雄县",
                "屏东县",
                "台东县",
                "花莲县",
                "澎湖县",
                "基隆市",
                "新竹市",
                "台中市",
                "嘉义市",
                "台南市",
                "台北市",
                "高雄市",
                "金门县",
                "连江县"
              ],
              "enumTitles": [
                "Guangzhou 广州 (广东)",
                "Shenzhen 深圳 (广东)",
                "Zhuhai 珠海 (广东)",
                "Chaozhou 潮州 (广东)",
                "Zhongshan 中山 (广东)",
                "Dongguan 东莞 (广东)",
                "Foshan 佛山 (广东)",
                "Huizhou 惠州 (广东)",
                "Shantou 汕头 (广东)",
                "Shanwei 汕尾 (广东)",
                "Shaoguan 韶关 (广东)",
                "Zhanjiang 湛江 (广东)",
                "Zhaoqing 肇庆 (广东)",
                "Heyuan 河源 (广东)",
                "Jiangmen 江门 (广东)",
                "Jieyang 揭阳 (广东)",
                "Maoming 茂名 (广东)",
                "Meizhou 梅州 (广东)",
                "Qingyuan 清远 (广东)",
                "Yangjiang 阳江 (广东)",
                "Yunfu 云浮 (广东)",
                "Hangzhou 杭州 (浙江)",
                "Ningbo 宁波 (浙江)",
                "Wenzhou 温州 (浙江)",
                "Shaoxing 绍兴 (浙江)",
                "Taizhou 台州 (浙江)",
                "Jiaxing 嘉兴 (浙江)",
                "Jinhua 金华 (浙江)",
                "Lishui 丽水 (浙江)",
                "Huzhou 湖州 (浙江)",
                "Quzhou 衢州 (浙江)",
                "Zhoushan 舟山 (浙江)",
                "Nanjing 南京 (江苏)",
                "Suzhou 苏州 (江苏)",
                "Wuxi 无锡 (江苏)",
                "Changzhou 常州 (江苏)",
                "Huaian 淮安 (江苏)",
                "Zhenjiang 镇江 (江苏)",
                "Yangzhou 扬州 (江苏)",
                "Xuzhou 徐州 (江苏)",
                "Lianyungang 连云港 (江苏)",
                "Nantong 南通 (江苏)",
                "Suqian 宿迁 (江苏)",
                "Taizhou 泰州 (江苏)",
                "Yancheng 盐城 (江苏)",
                "Jinan 济南 (山东)",
                "Qingdao 青岛 (山东)",
                "Yantai 烟台 (山东)",
                "Jining 济宁 (山东)",
                "Binzhou 滨州 (山东)",
                "Laiwu 莱芜 (山东)",
                "Rizhao 日照 (山东)",
                "Weifang 潍坊 (山东)",
                "Zibo 淄博 (山东)",
                "Dezhou 德州 (山东)",
                "Weihai 威海 (山东)",
                "Dongying 东营 (山东)",
                "Heze 菏泽 (山东)",
                "Liaocheng 聊城 (山东)",
                "Linyi 临沂 (山东)",
                "Taian 泰安 (山东)",
                "Zaozhuang 枣庄 (山东)",
                "Shijiazhuang 石家庄 (河北)",
                "Baoding 保定 (河北)",
                "Cangzhou 沧州 (河北)",
                "Qinhuangdao 秦皇岛 (河北)",
                "Chengde 承德 (河北)",
                "Handan 邯郸 (河北)",
                "Tangshan 唐山 (河北)",
                "Xingtai 邢台 (河北)",
                "Langfang 廊坊 (河北)",
                "Hengshui 衡水 (河北)",
                "Zhangjiakou 张家口 (河北)",
                "Zhengzhou 郑州 (河南)",
                "Luoyang 洛阳 (河南)",
                "Kaifeng 开封 (河南)",
                "Jiaozuo 焦作 (河南)",
                "Anyang 安阳 (河南)",
                "Nanyang 南阳 (河南)",
                "Zhoukou 周口 (河南)",
                "Shangqiu 商丘 (河南)",
                "Xinxiang 新乡 (河南)",
                "Hebi 鹤壁 (河南)",
                "Pingdingshan 平顶山 (河南)",
                "Sanmenxia 三门峡 (河南)",
                "Xinyang 信阳 (河南)",
                "Xuchang 许昌 (河南)",
                "Zhumadian 驻马店 (河南)",
                "Luohe 漯河 (河南)",
                "Puyang 濮阳 (河南)",
                "Fuzhou 福州 (福建)",
                "Xiamen 厦门 (福建)",
                "Quanzhou 泉州 (福建)",
                "Zhangzhou 漳州 (福建)",
                "Longyan 龙岩 (福建)",
                "Nanping 南平 (福建)",
                "Ningde 宁德 (福建)",
                "Putian 莆田 (福建)",
                "Sanming 三明 (福建)",
                "Shenyang 沈阳 (辽宁)",
                "Dalian 大连 (辽宁)",
                "Anshan 鞍山 (辽宁)",
                "Dandong 丹东 (辽宁)",
                "Fushun 抚顺 (辽宁)",
                "Benxi 本溪 (辽宁)",
                "Chaoyang 朝阳 (辽宁)",
                "Tieling 铁岭 (辽宁)",
                "Jinzhou 锦州 (辽宁)",
                "Liaoyang 辽阳 (辽宁)",
                "Fuxin 阜新 (辽宁)",
                "Huludao 葫芦岛 (辽宁)",
                "Panjin 盘锦 (辽宁)",
                "Yingkou 营口 (辽宁)",
                "Hefei 合肥 (安徽)",
                "Wuhu 芜湖 (安徽)",
                "Maanshan 马鞍山 (安徽)",
                "Huainan 淮南 (安徽)",
                "Bengbu 蚌埠 (安徽)",
                "Huangshan 黄山 (安徽)",
                "Fuyang 阜阳 (安徽)",
                "Huaibei 淮北 (安徽)",
                "Tongling 铜陵 (安徽)",
                "Bozhou 亳州 (安徽)",
                "Xuancheng 宣城 (安徽)",
                "Anqing 安庆 (安徽)",
                "Chaohu 巢湖 (安徽)",
                "Chizhou 池州 (安徽)",
                "Lu'an 六安 (安徽)",
                "Chuzhou 滁州 (安徽)",
                "Suzhou 宿州 (安徽)",
                "Nanning 南宁 (广西)",
                "Guilin 桂林 (广西)",
                "Beihai 北海 (广西)",
                "Liuzhou 柳州 (广西)",
                "Wuzhou 梧州 (广西)",
                "Yulin 玉林 (广西)",
                "Baise 百色 (广西)",
                "Chongzuo 崇左 (广西)",
                "Guigang 贵港 (广西)",
                "Hechi 河池 (广西)",
                "Hezhou 贺州 (广西)",
                "Laibin 来宾 (广西)",
                "Fangchenggang 防城港 (广西)",
                "Qinzhou 钦州 (广西)",
                "Taiyuan 太原 (山西)",
                "Datong 大同 (山西)",
                "Jincheng 晋城 (山西)",
                "Jinzhong 晋中 (山西)",
                "Linfen 临汾 (山西)",
                "Lüliang 吕梁 (山西)",
                "Shuozhou 朔州 (山西)",
                "Changzhi 长治 (山西)",
                "Xinzhou 忻州 (山西)",
                "Yangquan 阳泉 (山西)",
                "Yuncheng 运城 (山西)",
                "Haikou 海口 (海南)",
                "Sanya 三亚 (海南)",
                "Qionghai 琼海 (海南)",
                "Dongfang 东方 (海南)",
                "Danzhou 儋州 (海南)",
                "Wanning 万宁 (海南)",
                "Wenchang 文昌 (海南)",
                "Ding'an 定安县 (海南)",
                "Wuzhishan 五指山 (海南)",
                "Tunchang 屯昌县 (海南)",
                "Chengmai 澄迈县 (海南)",
                "Lingao 临高县 (海南)",
                "Baisha 白沙黎族自治县 (海南)",
                "Changjiang 昌江黎族自治县 (海南)",
                "Ledong 乐东黎族自治县 (海南)",
                "Lingshui 陵水黎族自治县 (海南)",
                "Qiongzhong 琼中黎族苗族自治县 (海南)",
                "Baoting 保亭黎族苗族自治县 (海南)",
                "Hohhot 呼和浩特 (内蒙古)",
                "Baotou 包头 (内蒙古)",
                "Chifeng 赤峰 (内蒙古)",
                "Ordos 鄂尔多斯 (内蒙古)",
                "Hulunbuir 呼伦贝尔 (内蒙古)",
                "Alxa League 阿拉善盟 (内蒙古)",
                "Tongliao 通辽 (内蒙古)",
                "Wuhai 乌海 (内蒙古)",
                "Hinggan 兴安盟 (内蒙古)",
                "Bayannur 巴彦淖尔 (内蒙古)",
                "Ulanqab 乌兰察布盟 (内蒙古)",
                "Xilingol League 锡林郭勒盟 (内蒙古)",
                "Changchun 长春 (吉林)",
                "Jilin 吉林 (吉林)",
                "Siping 四平 (吉林)",
                "Tonghua 通化 (吉林)",
                "Baicheng 白城 (吉林)",
                "Baishan 白山 (吉林)",
                "Liaoyuan 辽源 (吉林)",
                "Songyuan 松原 (吉林)",
                "Yanbian 延边朝鲜族自治州 (吉林)",
                "Harbin 哈尔滨 (黑龙江)",
                "Daqing 大庆 (黑龙江)",
                "Jiamusi 佳木斯 (黑龙江)",
                "Hegang 鹤岗 (黑龙江)",
                "Mudanjiang 牡丹江 (黑龙江)",
                "Heihe 黑河 (黑龙江)",
                "Jixi 鸡西 (黑龙江)",
                "Qitaihe 七台河 (黑龙江)",
                "Qiqihar 齐齐哈尔 (黑龙江)",
                "Shuangyashan 双鸭山 (黑龙江)",
                "Suihua 绥化 (黑龙江)",
                "Yichun 伊春 (黑龙江)",
                "Da Hinggan Ling 大兴安岭 (黑龙江)",
                "Wuhan 武汉 (湖北)",
                "Huanggang 黄冈 (湖北)",
                "Huangshi 黄石 (湖北)",
                "Jingmen 荆门 (湖北)",
                "Jingzhou 荆州 (湖北)",
                "Qianjiang 潜江 (湖北)",
                "Yichang 宜昌 (湖北)",
                "Ezhou 鄂州 (湖北)",
                "Shiyan 十堰 (湖北)",
                "Suizhou 随州 (湖北)",
                "Tianmen 天门 (湖北)",
                "Xiantao 仙桃 (湖北)",
                "Xianning 咸宁 (湖北)",
                "Xiangfan 襄樊 (湖北)",
                "Xiaogan 孝感 (湖北)",
                "Shennongjia 神农架林区 (湖北)",
                "Enshi 恩施土家族苗族自治州 (湖北)",
                "Changsha 长沙 (湖南)",
                "Changde 常德 (湖南)",
                "Zhuzhou 株洲 (湖南)",
                "Yueyang 岳阳 (湖南)",
                "Chenzhou 郴州 (湖南)",
                "Huaihua 怀化 (湖南)",
                "Xiangtan 湘潭 (湖南)",
                "Zhangjiajie 张家界 (湖南)",
                "Hengyang 衡阳 (湖南)",
                "Loudi 娄底 (湖南)",
                "Shaoyang 邵阳 (湖南)",
                "Yiyang 益阳 (湖南)",
                "Yongzhou 永州 (湖南)",
                "Xiangxi 湘西土家族苗族自治州 (湖南)",
                "Nanchang 南昌 (江西)",
                "Shangrao 上饶 (江西)",
                "Fuzhou 抚州 (江西)",
                "Ganzhou 赣州 (江西)",
                "Jiujiang 九江 (江西)",
                "Yingtan 鹰潭 (江西)",
                "Jian 吉安 (江西)",
                "Jingdezhen 景德镇 (江西)",
                "Pingxiang 萍乡 (江西)",
                "Xinyu 新余 (江西)",
                "Yichun 宜春 (江西)",
                "Yinchuan 银川 (宁夏)",
                "Guyuan 固原 (宁夏)",
                "Shizuishan 石嘴山 (宁夏)",
                "Wuzhong 吴忠 (宁夏)",
                "Zhongwei 中卫 (宁夏)",
                "Urumqi 乌鲁木齐 (新疆)",
                "Hami 哈密 (新疆)",
                "Hetian 和田 (新疆)",
                "Kashgar 喀什 (新疆)",
                "Turpan 吐鲁番 (新疆)",
                "Aksu 阿克苏 (新疆)",
                "Alaer 阿拉尔 (新疆)",
                "Shihezi 石河子 (新疆)",
                "Wujiaqu 五家渠 (新疆)",
                "Karamay 克拉玛依 (新疆)",
                "Tumushuke 图木舒克 (新疆)",
                "Changji 昌吉回族自治州 (新疆)",
                "Yili 伊犁哈萨克自治州 (新疆)",
                "Bayinguoleng 巴音郭楞蒙古自治州 (新疆)",
                "Boertala 博尔塔拉蒙古自治州 (新疆)",
                "Kezilesu 克孜勒苏柯尔克孜自治州 (新疆)",
                "Tacheng 塔城地区 (新疆)",
                "Aletai 阿勒泰地区 (新疆)",
                "Xining 西宁 (青海)",
                "Haidong 海东 (青海)",
                "Guoluo 果洛藏族自治州 (青海)",
                "Haibei 海北藏族自治州 (青海)",
                "Hainan 海南藏族自治州 (青海)",
                "Huangnan 黄南藏族自治州 (青海)",
                "Yushu 玉树藏族自治州 (青海)",
                "Haixi 海西蒙古族藏族自治州 (青海)",
                "Xian 西安 (陕西)",
                "Xianyang 咸阳 (陕西)",
                "Hanzhong 汉中 (陕西)",
                "Ankang 安康 (陕西)",
                "Baoji 宝鸡 (陕西)",
                "Shangluo 商洛 (陕西)",
                "Tongchuan 铜川 (陕西)",
                "Weinan 渭南 (陕西)",
                "Yanan 延安 (陕西)",
                "Yulin 榆林 (陕西)",
                "Lanzhou 兰州 (甘肃)",
                "Baiyin 白银 (甘肃)",
                "Jiuquan 酒泉 (甘肃)",
                "Dingxi 定西 (甘肃)",
                "Jiayuguan 嘉峪关 (甘肃)",
                "Jinchang 金昌 (甘肃)",
                "Qingyang 庆阳 (甘肃)",
                "Longnan 陇南 (甘肃)",
                "Pingliang 平凉 (甘肃)",
                "Tianshui 天水 (甘肃)",
                "Wuwei 武威 (甘肃)",
                "Zhangye 张掖 (甘肃)",
                "Gannan 甘南藏族自治州 (甘肃)",
                "Linxia 临夏回族自治州 (甘肃)",
                "Chengdu 成都 (四川)",
                "Yibin 宜宾 (四川)",
                "Mianyang 绵阳 (四川)",
                "Bazhong 巴中 (四川)",
                "Panzhihua 攀枝花 (四川)",
                "Dazhou 达州 (四川)",
                "Deyang 德阳 (四川)",
                "Suining 遂宁 (四川)",
                "Guangan 广安 (四川)",
                "Guangyuan 广元 (四川)",
                "Leshan 乐山 (四川)",
                "Luzhou 泸州 (四川)",
                "Meishan 眉山 (四川)",
                "Nanchong 南充 (四川)",
                "Neijiang 内江 (四川)",
                "Yaan 雅安 (四川)",
                "Ziyang 资阳 (四川)",
                "Zigong 自贡 (四川)",
                "Ganzi 甘孜藏族自治州 (四川)",
                "Liangshan 凉山彝族自治州 (四川)",
                "Aba 阿坝藏族羌族自治州 (四川)",
                "Kunming 昆明 (云南)",
                "Baoshan 保山 (云南)",
                "Lijiang 丽江 (云南)",
                "Yuxi 玉溪 (云南)",
                "Zhaotong 昭通 (云南)",
                "Lincang 临沧 (云南)",
                "Qujing 曲靖 (云南)",
                "Puer 普洱 (云南)",
                "Chuxiong 楚雄彝族自治州 (云南)",
                "Dali 大理白族自治州 (云南)",
                "Diqing 迪庆藏族自治州 (云南)",
                "Nujiang 怒江傈傈族自治州 (云南)",
                "Wenshan 文山壮族苗族自治州 (云南)",
                "Xishuangbanna 西双版纳傣族自治州 (云南)",
                "Dehong 德宏傣族景颇族自治州 (云南)",
                "Honghe 红河哈尼族彝族自治州 (云南)",
                "Guiyang 贵阳 (贵州)",
                "Anshun 安顺 (贵州)",
                "Bijie 毕节 (贵州)",
                "Tongren 铜仁 (贵州)",
                "Zunyi 遵义 (贵州)",
                "Liupanshui 六盘水 (贵州)",
                "Qiandongnan 黔东南苗族侗族自治州 (贵州)",
                "Qiannan 黔南布依族苗族自治州 (贵州)",
                "Qianxinan 黔西南布依族苗族自治州 (贵州)",
                "Lhasa 拉萨 (西藏)",
                "Ali 阿里 (西藏)",
                "Changdou 昌都 (西藏)",
                "Linzhi 林芝 (西藏)",
                "Naqu 那曲 (西藏)",
                "Shigatse 日喀则 (西藏)",
                "Shannan 山南 (西藏)",
                "Hong Kong Island 香港岛 (香港)",
                "Kowloon 九龙 (香港)",
                "New Territories 新界 (香港)",
                "Macau Peninsula 澳门半岛 (澳门)",
                "Macau Islands 澳门离岛 (澳门)",
                "Taibei 台北县 (台湾)",
                "Yilan 宜兰县 (台湾)",
                "Taoyuan 桃园县 (台湾)",
                "Xinzhu 新竹县 (台湾)",
                "Miaoli 苗栗县 (台湾)",
                "Taizhong 台中县 (台湾)",
                "Zhanghua 彰化县 (台湾)",
                "Nantou 南投县 (台湾)",
                "Yunlin 云林县 (台湾)",
                "Jiayi 嘉义县 (台湾)",
                "Tainan 台南县 (台湾)",
                "Gaoxiong 高雄县 (台湾)",
                "Pingdong 屏东县 (台湾)",
                "Taidong 台东县 (台湾)",
                "Hualian 花莲县 (台湾)",
                "Penghu 澎湖县 (台湾)",
                "Jilongshi 基隆市 (台湾)",
                "Xinzhushi 新竹市 (台湾)",
                "Taizhongshi 台中市 (台湾)",
                "Jiayishi 嘉义市 (台湾)",
                "Tainanshi 台南市 (台湾)",
                "Taibeishi 台北市 (台湾)",
                "Gaoxiongshi 高雄市 (台湾)",
                "Jinmen 金门县 (台湾)",
                "Lianjiang 连江县 (台湾)"
              ]
            }
          },
          "supplierFeatures": {
            "title": "1688: supplier and service features",
            "type": "array",
            "description": "1688's own filters. Two from the same group (the word before the colon) keep offers with either one; filters from different groups must all hold.",
            "items": {
              "type": "string",
              "enum": [
                "dropshipping",
                "listingMaterials",
                "dropshippingFreeShipping",
                "freeShipping",
                "distributionPick",
                "waybillDouyin",
                "waybillKuaishou",
                "waybillPinduoduo",
                "waybillXiaohongshu",
                "waybillTaobao",
                "waybillJd",
                "wechatShop",
                "realFactoryCertified",
                "strengthCertified",
                "bigBrandOem",
                "freeReturnShipping",
                "fastInvoice"
              ],
              "enumTitles": [
                "Dropshipping: ships single pieces (一件代发)",
                "Dropshipping: listing photo pack (铺货素材包)",
                "Shipping: single pieces with free shipping (1件代发包邮)",
                "Shipping: free shipping (包邮)",
                "Shipping: 1688 dropshipping pick (分销严选)",
                "Shipping: Douyin waybill (抖音面单)",
                "Shipping: Kuaishou waybill (快手面单)",
                "Shipping: Pinduoduo waybill (多多面单)",
                "Shipping: RedNote waybill (小红书面单)",
                "Shipping: Taobao waybill (淘宝面单)",
                "Shipping: JD waybill (京东面单)",
                "Shipping: WeChat shop orders (微信小店)",
                "Supplier: certified real factory (真实工厂认证)",
                "Supplier: certified strong merchant (实力认证)",
                "Supplier: makes for big brands (大牌代工)",
                "Service: return shipping covered (退货包运费)",
                "Service: fast invoicing (极速开票)"
              ]
            }
          },
          "excludeKeywords": {
            "title": "Leave out titles with these words",
            "type": "array",
            "description": "Products whose title contains any of these words are dropped and never charged, on every marketplace. Not case-sensitive; Chinese words work on 1688 titles.",
            "items": {
              "type": "string"
            }
          },
          "excludeAds": {
            "title": "Leave out sponsored listings",
            "type": "boolean",
            "description": "Drop products a marketplace marks as paid placements. Rows left out are not charged.",
            "default": false
          },
          "includeDetails": {
            "title": "1688: add each product's page",
            "type": "boolean",
            "description": "Reads the product page of every 1688 match and adds its price ladder, stock, weight per unit, ship-from city, dispatch promise, buyer protections and full gallery. Each page is charged only when it is in your row.",
            "default": false
          },
          "translateTo": {
            "title": "Translate titles, attributes and tags into",
            "enum": [
              "",
              "en",
              "es",
              "pt",
              "fr",
              "de",
              "it",
              "nl",
              "pl",
              "ru",
              "uk",
              "tr",
              "ar",
              "he",
              "ja",
              "ko",
              "zh-CN",
              "zh-TW",
              "vi",
              "th",
              "id",
              "ms",
              "hi",
              "sv",
              "da",
              "no",
              "fi",
              "cs",
              "ro",
              "hu",
              "el"
            ],
            "type": "string",
            "description": "1688 writes in Chinese. Pick a language and every row also gets titleTranslated and translated attributes and tags, at no extra charge. Alibaba.com and AliExpress rows, already in English, are translated only into another language.",
            "default": ""
          },
          "shippingCostPerKgUsd": {
            "title": "Your shipping rate per kg (USD), for landed cost",
            "minimum": 0,
            "maximum": 1000,
            "type": "number",
            "description": "With the product pages on, each 1688 row gets landedCostUsd: its price in US dollars, plus this rate times the weight per unit on its page, plus the duty below. Leave it empty for no landed cost."
          },
          "dutyPercent": {
            "title": "Your duty rate (%), for landed cost",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Added on the dollar price when landedCostUsd is worked out. Empty means none."
          },
          "currency": {
            "title": "Currency for Alibaba.com and AliExpress",
            "enum": [
              "USD",
              "EUR",
              "GBP",
              "CAD",
              "AUD",
              "JPY",
              "KRW",
              "BRL",
              "MXN",
              "INR",
              "RUB",
              "TRY",
              "PLN",
              "SEK",
              "CHF",
              "NZD",
              "SGD",
              "HKD",
              "ILS",
              "SAR",
              "AED",
              "ZAR",
              "NOK",
              "DKK",
              "CZK",
              "HUF",
              "CLP",
              "COP",
              "PEN",
              "UAH",
              "KZT",
              "IDR",
              "THB",
              "VND",
              "PHP",
              "MYR"
            ],
            "type": "string",
            "description": "The currency those two show prices in. 1688 prices are always in Chinese yuan (CNY).",
            "default": "USD"
          },
          "shipTo": {
            "title": "AliExpress: ship-to country",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "Two-letter country code AliExpress works out prices and availability for, such as US, GB, DE or BR.",
            "default": "US"
          },
          "onlyNewResultsName": {
            "title": "Only new results: a name for this search",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9-]{0,49}$",
            "type": "string",
            "description": "Give the search a name, such as summer-dresses, and every later run with the same name skips products it already delivered, free. Handy on a schedule. Letters, digits and dashes. Empty means every run returns everything."
          },
          "compareWithPreviousRun": {
            "title": "Compare with the previous run",
            "type": "boolean",
            "description": "Adds what each product cost and had sold on the previous run of the same search: previousPrice, priceChange, previousSoldCount and soldSincePreviousRun. A product that run didn't have is marked isNewSinceLastRun.",
            "default": false
          },
          "snapshotName": {
            "title": "Name for the comparison",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9-]{0,49}$",
            "type": "string",
            "description": "Optional. Runs with the same name compare with each other. Empty means the same pictures and marketplaces compare with themselves. Letters, digits and dashes."
          },
          "proxyConfiguration": {
            "title": "Your own proxy servers (not needed)",
            "type": "object",
            "description": "Optional. The run works without it. Proxy URLs given here are the only connections the run uses.",
            "default": {
              "useApifyProxy": false
            }
          },
          "maxConcurrency": {
            "title": "Pictures searched at once",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "1 to 5. More finishes a long list sooner; rows still come out in picture order.",
            "default": 1
          },
          "minDelaySecs": {
            "title": "Shortest pause between pictures (seconds)",
            "minimum": 0,
            "maximum": 60,
            "type": "number",
            "description": "Before each next picture, or group of pictures, the run waits a random time between the shortest and the longest pause.",
            "default": 0
          },
          "maxDelaySecs": {
            "title": "Longest pause between pictures (seconds)",
            "minimum": 0,
            "maximum": 60,
            "type": "number",
            "description": "Leave it at 0 for no pause.",
            "default": 0
          },
          "maxRetries": {
            "title": "Extra tries for a marketplace that doesn't answer",
            "minimum": 0,
            "maximum": 3,
            "type": "integer",
            "description": "0 to 3, each after the pause set above. A marketplace that still doesn't answer is skipped for the rest of the run, with a free note.",
            "default": 0
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}