{
  "openapi": "3.0.1",
  "info": {
    "title": "1688 Wholesale Products Scraper",
    "description": "Scrape 1688.com wholesale products by English or Chinese keyword or link, no login or cookies. Get bulk price tiers, MOQ, units sold, supplier trust, SKUs and shipping in USD or other currencies. Filter factories. Clean JSON for sourcing and price tracking.",
    "version": "1.0",
    "x-build-id": "nQtCNJlqe26gcJQ3b"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/data_wiki~1688-wholesale-products-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-data_wiki-1688-wholesale-products-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/data_wiki~1688-wholesale-products-scraper/runs": {
      "post": {
        "operationId": "runs-sync-data_wiki-1688-wholesale-products-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/data_wiki~1688-wholesale-products-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-data_wiki-1688-wholesale-products-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": {
          "keywords": {
            "title": "🔍 Search keywords",
            "type": "array",
            "description": "Products to search for, one per line. English (wireless earbuds, phone case) or Chinese (手机壳, 蓝牙耳机) both work; English is translated for you. Each keyword is searched separately and 'Max results' applies per keyword. Ignored when product links or IDs are filled.",
            "items": {
              "type": "string"
            }
          },
          "urls": {
            "title": "🔗 Product links or IDs",
            "type": "array",
            "description": "1688 product links (https://detail.1688.com/offer/735353578254.html) or plain offer IDs (735353578254), in bulk. Skips the search: when filled, keywords and filters are ignored and each product page is read for full details. If you do not use search, this is the field to fill.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "📊 Max results per keyword",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum products per keyword (0 = everything 1688 lets this search reach). Ignored for product links.",
            "default": 10
          },
          "sortBy": {
            "title": "🏆 Sort order",
            "enum": [
              "relevance",
              "bestSelling",
              "priceAsc",
              "priceDesc"
            ],
            "type": "string",
            "description": "How 1688 orders the search results.",
            "default": "relevance"
          },
          "priceMin": {
            "title": "💴 Minimum price (CNY)",
            "minimum": 0,
            "type": "number",
            "description": "Only products priced at or above this value, in Chinese yuan. Leave at 0 for no minimum.",
            "default": 0
          },
          "priceMax": {
            "title": "💎 Maximum price (CNY)",
            "minimum": 0,
            "type": "number",
            "description": "Only products priced at or below this value, in Chinese yuan. Leave at 0 for no maximum.",
            "default": 0
          },
          "minOrderQuantity": {
            "title": "📦 Max minimum-order quantity",
            "minimum": 0,
            "type": "integer",
            "description": "Only suppliers whose minimum order is at most this many pieces. Useful for suppliers who sell small quantities. Leave at 0 for no limit.",
            "default": 0
          },
          "minSold": {
            "title": "🔥 Minimum units sold",
            "minimum": 0,
            "type": "integer",
            "description": "Only products with at least this many units sold, as shown on the listing. Leave at 0 for no minimum.",
            "default": 0
          },
          "merchantType": {
            "title": "🏅 Merchant badge",
            "enum": [
              "any",
              "superFactory",
              "verifiedMerchant",
              "sourceFlagship"
            ],
            "type": "string",
            "description": "Only suppliers with this 1688 verification badge: Super Factory (超级工厂), Verified Merchant (实力商家) or Source Flagship (源头旗舰).",
            "default": "any"
          },
          "supplierType": {
            "title": "🏢 Supplier type",
            "enum": [
              "any",
              "factory",
              "wholesaler",
              "agent"
            ],
            "type": "string",
            "description": "Only factories (生产加工), wholesalers (经销批发) or sourcing agents (招商代理).",
            "default": "any"
          },
          "province": {
            "title": "🌏 Supplier provinces",
            "type": "array",
            "description": "Only suppliers in these provinces, English or Chinese (Guangdong, Zhejiang, 广东). One search pass is made per province and the results are merged.",
            "items": {
              "type": "string"
            }
          },
          "city": {
            "title": "🌆 Supplier cities",
            "type": "array",
            "description": "Only suppliers in these cities, English or Chinese (Shenzhen, Yiwu, 深圳). One search pass is made per city. When cities are given they are used instead of provinces for the search.",
            "items": {
              "type": "string"
            }
          },
          "dropshipReady": {
            "title": "🚚 One-piece dropshipping",
            "type": "boolean",
            "description": "Only suppliers that offer one-piece dropshipping. Cannot be combined with the 48-hour switch; this one wins.",
            "default": false
          },
          "fastDispatch48h": {
            "title": "⚡ Ships within 48 hours",
            "type": "boolean",
            "description": "Only products promised to ship within 48 hours.",
            "default": false
          },
          "freeShipping": {
            "title": "🎁 Free shipping",
            "type": "boolean",
            "description": "Only products with free shipping.",
            "default": false
          },
          "newArrivals": {
            "title": "🆕 New arrivals",
            "type": "boolean",
            "description": "Only newly listed products.",
            "default": false
          },
          "onePerSupplier": {
            "title": "🧩 One offer per supplier",
            "type": "boolean",
            "description": "Keep a single product per supplier. Good for finding new suppliers.",
            "default": false
          },
          "includePromoted": {
            "title": "📣 Include paid ads",
            "type": "boolean",
            "description": "Paid-placement ads are left out unless you switch this on.",
            "default": false
          },
          "translate": {
            "title": "🔤 English titles and tags",
            "type": "boolean",
            "description": "Adds titleEn, tagsEn and serviceTagsEn to every product and translates English keywords to Chinese before searching.",
            "default": true
          },
          "convertTo": {
            "title": "💱 Also show prices in",
            "enum": [
              "USD",
              "EUR",
              "GBP",
              "CNY",
              "JPY",
              "KRW",
              "HKD",
              "SGD",
              "AUD",
              "CAD",
              "INR",
              "AED",
              "BRL",
              "MXN",
              "TRY",
              "RUB"
            ],
            "type": "string",
            "description": "Prices are always in Chinese yuan; they are also converted to this currency at the current exchange rate.",
            "default": "USD"
          },
          "includeDetails": {
            "title": "🔬 Full product page details",
            "type": "boolean",
            "description": "Reads each product page for the SKU variant matrix (colours, sizes, weight), specs, shipping, reviews, services and coupons. Best effort: 1688 refuses some product pages, and each row's detailStatus says ok or blocked. Slower and makes rows larger.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "🌐 Proxy",
            "type": "object",
            "description": "Leave as is to start without a proxy; if 1688 refuses a request the run switches to a datacenter proxy and then to a residential proxy by itself. Pick a proxy here to start with it instead.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}