{
  "openapi": "3.0.1",
  "info": {
    "title": "1688 Wholesale Scraper — Tier Pricing · MOQ · Supplier Data",
    "description": "Scrape 1688.com B2B wholesale into clean datasets. Keyword product search plus sourcing-grade detail: quantity-break tier pricing, MOQ, supplier company & location, SKU attributes, image galleries and export-platform tags (Amazon, eBay, AliExpress). For sourcing agents & dropshippers.",
    "version": "1.0",
    "x-build-id": "EPJM6fZLDjFUEH0Es"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/sian.agency~alibaba-1688-wholesale-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-sian.agency-alibaba-1688-wholesale-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/sian.agency~alibaba-1688-wholesale-scraper/runs": {
      "post": {
        "operationId": "runs-sync-sian.agency-alibaba-1688-wholesale-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/sian.agency~alibaba-1688-wholesale-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-sian.agency-alibaba-1688-wholesale-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": {
          "operation": {
            "title": "Operation",
            "enum": [
              "searchItem",
              "searchProducts",
              "itemDetail",
              "itemDetailV2",
              "itemDescriptionImages",
              "itemReviews",
              "itemShipping",
              "imageSearch",
              "shopProducts",
              "shopInfo",
              "shopCategories",
              "categoryInfo",
              "categoryProducts",
              "factorySearch",
              "crossBorderSearch",
              "crossBorderImageSearch"
            ],
            "type": "string",
            "description": "Pick what you want to scrape. Each run does one operation. Classic Product Search / Product Detail keep their original output; the others add paging, filters, reviews, suppliers, categories and image search.",
            "default": "searchItem"
          },
          "keyword": {
            "title": "🔎 Search Keyword (for Product Search)",
            "type": "string",
            "description": "Search query (Product Search, Factory Search, Cross-border Search). Chinese gives the best results (try 手机壳, 数据线, 蓝牙耳机).",
            "default": "手机壳"
          },
          "itemId": {
            "title": "🏷️ Product ID (for Product Detail)",
            "type": "string",
            "description": "Numeric 1688 product ID (from detail.1688.com/offer/{ID}.html, or the `itemId` of any search row). Used by Product Detail, Description Images, Reviews and Shipping."
          },
          "itemUrl": {
            "title": "🔗 Product URL",
            "type": "string",
            "description": "Product Detail (full) only: a detail.1688.com product URL, used when no Product ID is given."
          },
          "imageUrl": {
            "title": "🖼️ Image URL",
            "type": "string",
            "description": "Public image URL for Search by Image, Cross-border Search by Image and Image Conversion."
          },
          "memberId": {
            "title": "🏢 Supplier Member ID",
            "type": "string",
            "description": "Seller member ID (b2b-…), found in the `supplierMemberId` column of search, factory and detail rows. Used by Shop Products, Shop Information and Shop Categories."
          },
          "shopUrl": {
            "title": "🏬 Shop URL",
            "type": "string",
            "description": "Shop homepage URL like https://shop123.1688.com (alternative to Member ID)."
          },
          "catId": {
            "title": "🧭 Category ID",
            "type": "string",
            "description": "1688 category ID. Leave empty on Category Information to list the top-level categories."
          },
          "maxResults": {
            "title": "📦 Max results",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Stop after this many rows (paged operations fetch pages until reached). Free plan runs return at most 25.",
            "default": 20
          },
          "sort": {
            "title": "↕️ Sort",
            "enum": [
              "default",
              "sales",
              "price_up",
              "price_down"
            ],
            "type": "string",
            "description": "Sort order for search and category operations.",
            "default": "default"
          },
          "priceStart": {
            "title": "💴 Min price (CNY)",
            "type": "string",
            "description": "Minimum unit price filter."
          },
          "priceEnd": {
            "title": "💴 Max price (CNY)",
            "type": "string",
            "description": "Maximum unit price filter."
          },
          "moq": {
            "title": "📏 Max MOQ filter",
            "type": "integer",
            "description": "Minimum-order-quantity filter for search operations."
          },
          "newArrival": {
            "title": "🆕 New arrivals only",
            "type": "boolean",
            "description": "Only newly listed products."
          },
          "supportDropshipping": {
            "title": "📮 Dropshipping only",
            "type": "boolean",
            "description": "Only offers that support dropshipping."
          },
          "freeShipping": {
            "title": "🚚 Free shipping only",
            "type": "boolean",
            "description": "Only offers with free shipping."
          },
          "isSuperFactory": {
            "title": "🏭 Super factories only",
            "type": "boolean",
            "description": "Only super-factory suppliers (search and category operations)."
          },
          "isFactory": {
            "title": "🏭 Factories only",
            "type": "boolean",
            "description": "Image search: only factory suppliers."
          },
          "verifiedSupplier": {
            "title": "✅ Verified suppliers only",
            "type": "boolean",
            "description": "Image search: only verified suppliers."
          },
          "language": {
            "title": "🌐 Output language",
            "enum": [
              "en",
              "zh",
              "ru",
              "th",
              "pt",
              "es",
              "tr",
              "vi",
              "ja",
              "ko"
            ],
            "type": "string",
            "description": "Language for product text on Product Detail (full), Category Products and Cross-border operations. Not every language is supported by every operation; unsupported values are rejected with an error row."
          },
          "dropshippingScene": {
            "title": "📮 Dropshipping prices",
            "type": "boolean",
            "description": "Product Detail (full): return dropshipping pricing."
          },
          "optimizeTitle": {
            "title": "✂️ Shorten titles",
            "type": "boolean",
            "description": "Product Detail (full): strip non-core words from Chinese titles."
          },
          "reviewSort": {
            "title": "⭐ Review order",
            "enum": [
              "default",
              "latest"
            ],
            "type": "string",
            "description": "Product Reviews sort order.",
            "default": "default"
          },
          "province": {
            "title": "📍 Destination province",
            "type": "string",
            "description": "Shipping Fee Estimate: Chinese province code, e.g. gd (Guangdong), zj, js, sh, bj. Use the two-letter abbreviation."
          },
          "totalQuantity": {
            "title": "🔢 Quantity",
            "type": "integer",
            "description": "Shipping Fee Estimate: number of units to ship.",
            "default": 1
          },
          "totalWeight": {
            "title": "⚖️ Total weight (kg)",
            "type": "number",
            "description": "Shipping Fee Estimate: optional total weight."
          },
          "shopSort": {
            "title": "↕️ Shop product order",
            "enum": [
              "default",
              "sales",
              "price_up",
              "price_down",
              "time_up",
              "time_down"
            ],
            "type": "string",
            "description": "Shop Products sort order.",
            "default": "default"
          },
          "shopCatId": {
            "title": "🗂️ Shop category ID",
            "type": "string",
            "description": "Shop Products: only this shop category (IDs come from Shop Categories)."
          },
          "factorySort": {
            "title": "↕️ Factory order",
            "enum": [
              "default",
              "repurchase_rate"
            ],
            "type": "string",
            "description": "Factory Search sort order.",
            "default": "default"
          },
          "categoryApi": {
            "title": "📚 Category listing",
            "enum": [
              "v2",
              "v1"
            ],
            "type": "string",
            "description": "Category Products: full listing (default) or the lighter classic listing.",
            "default": "v2"
          },
          "crossBorderImageVersion": {
            "title": "🌍 Cross-border image engine",
            "enum": [
              "v1",
              "v2"
            ],
            "type": "string",
            "description": "Cross-border Search by Image: which matching engine to use.",
            "default": "v1"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}